Belgeleri incele
Başlarken
Ajan Google Search ve YouTube araçlarınızı verin. Ev sahibine bağlan, sonra ilk sonucunuzu isteyin.
Bu sayfada
1. Connect ve işaret
Codex veya OpenClaw'u tarayıcı tabanlı OAuth için seçin. Başka bir ev sahibi için, API anahtarını Streamable HTTP ve özel başlıkları veya Local / stdio'yu başlatırsa MCP süreçleri başlatır. Ev sahibi sunucunun yerel bir kuruluma ihtiyacı yoktur.
Aşağıdaki yapılandırın -/.codex/config.toml, sonra giriş komutunu çalıştırın. FlashData işareti veya işaret-in ve tarayıcıda onay. Giriş yaptıktan sonra taze bir Codex seansı başlayın.
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"
[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"codex mcp login flashdata --scopes mcp:researchBu komutları OpenClaw profilinde çalıştırın. Tarayıcıda tam işaret veya işaret-in ve onay, sonra taze bir seans başlatır. Doktor probe, kurtarılan bağlantıyı kontrol eder.
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probeGoogle Search izni ile anahtar oluşturun veya bir tane yeniden kullanın. Ev sahibinizin MCP ayarlarını aşağıdaki alanları kullanarak bir sunucu ekleyin. Korumalı başlık alanında anahtarı koyun ve yeniden bağlantı kurun; OAuth komutuna gerek yok.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYNode.js 22.18+ ve API anahtarı ile Google Search izni gerekir. Bu, mcpServers JSON'u destekleyen bir ev sahibine. YOUR_API_KEY'u yerel korunan konfigürasyonunda değiştirin, sonra ev sahibi yeniden başlayın. npx.cmd'u Windows'de kullanın, ev sahibinin eklenebilir bir dosya adı gerektirdiği takdirde.
pinned npm paketi yerel MCP sunucuyu çalıştırıyor. The standalone FlashData CLI ayrı bir executable.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. Bağlantıyı kontrol edin
Bunu taze bir ajan oturumunda gönderin. Başarılı get_pricing ve get_balance çağrılarını bekleyin, google_search ve mevcut kredi bakiyeniz için mevcut bir fiyat. Sıfır bir denge, arama için kredilere ihtiyacınız olduğu anlamına gelir; doğrulama başarısız anlamına gelmez.
Mevcut flashdata MCP bağlantısını kullanın.
get_pricing ile {"source":"google_search","request_count":1}'u arayın.
get_balance ile {}'u arayın.
Her iki aramanın başarılı olup olmadığını rapor edin, kaynağın mevcut bir fiyat olup olmadığını,
Ve mevcut kredi dengesi. Sıfır bir denge bir doğrulama başarısızlığı değildir.
Bir arama veya indirme çalıştırmayın, bir deneme oluşturun veya kimlik değiştirir.3. İlk göreviniz için sorun
Bunu bağlı ajanınıza yapıştırın. Denge ve fiyat kontrolleri ücretsizdir; arama hesap kredilerini kullanır.
FlashData'i dengemi kontrol etmek ve bir Google arama fiyatı kullanın. Eğer yeterli kredi varsa, google_search ile bir kez sorgu "battery recycling research", num 5 ve mod "realtime". Geri dönüş başlıkları, kaynak URLs, kısa alıntılar ve gerçek krediler kullanılır. Bu görevden sonra durun.Sonucu kontrol edin
Ajanınız kaynak bağlantılarını ve alıntılarını geri getirmelidir, artı kullanılan gerçek krediler. Temel arama sonucu status: done ve results[].organic. Boş bir sonuç geçerlidir; ajan bunu rapor etmelidir. Aşağıdaki örnek, açıklayıcıdır.
Tamamlanan bir Google arama.
1. Battery geri dönüşüm araştırmaları - https://example.org/recycling
Bir örnek arama bölümü.
Krediler kullanılır: 0.02Mevcut aletler
API-key aramaları bu anahtara verilen izinleri kullanır. Tüm mevcut katalog için sunucunun araçlarını ve giriş şemalarını keşfedin.
| Görev Görev Görevi | Tool Tool Tool | Erişim |
|---|---|---|
| Arama Google | google_search | mcp:research / API key |
| YouTube videoları bulun | youtube_search | mcp:research / API key |
| Video metadata | youtube_metadata | mcp:research / API key |
| Mevcut komutlar erişim | youtube_transcript | mcp:research / API key |
| Video veya ses indir | youtube_download | Sahibi API anahtar + hedef depolama |
| Check account and pricing | get_balance, get_pricing, get_limits, get_usage | Ücretsiz hesap okur |
OAuth hakkında, izinler ve denemeler
OAuth doğrulanmış sahibi hesabınızı birleştirir ve ev sahibi mağazayı ve yeni jetonları yenilemenize izin verir. mcp:research hibe yukarıdaki dört araştırma kaynağını kapsar. API-key bağlantıları korumalı bir X-API-Key başlığı kullanıyor ve diğer yetkili kaynakları da içerebilir.
FlashData'u bir hesap oluşturmadan önce denemek için, CLI deneme akışını kullanın. MCP OAuth bir sahibi hesabı bağlar; bir deneme kaydetme veya iddia etmez. A CLI profili otomatik olarak MCP host ile paylaşılmaz.
Sorun Giderme
| Problem Sorun Problem Problem Problem | Bunu dene |
|---|---|
| FlashData aletleri | Bitirme, yeniden bağlantı kurmak ve taze bir seansa başlayın. URL ve Streamable HTTP taşımasını kontrol edin. |
| invalid_client / callback error | Codex veya OpenClaw için, yerel çağrıya ulaşabilen tam müşteri yapılandırmasını ve bir tarayıcıyı kullanın. Başka bir ev sahibi için, desteklenen API-key veya stdio kurulumunu yukarıda kullanın. |
| 401 | Yeniden bağlantı sona ermiş veya OAuth erişimi iptal edildi veya ev sahibine verilen API anahtarını kontrol edin. Ücretsiz çeki tekrarlayın. |
| 403 | Talep edilen kaynağı ve anahtar izinleri kontrol edin. YouTube Download Bir sahibin bir sahibi gerektirir API anahtarla anahtarla youtube_download Hedef depolama; mcp:research Buna dahil değildir. |
| 402 | Billing ve mevcut fiyat kontrol edin. Geçerli bir credential ile bağlantı kurmak kredi eklemez. |
| 429 | Retry-After'u izleyin. Mevcut herhangi bir iş tutun veya görevi yeniden denemeyi karar vermeden önce ID'yu sonuçlayın. |
| Zamanout veya eksik cevap | ID'u talep edin ve History'u kontrol edin. Aramayı tekrarlamak yerine get_result ile büyük devamları okuyun. |