Belgeleri incele
API başvurusu
MCP araçları ve şemaları
FlashData MCP araç argümanları, varsayılanlar, hesap okur, iş eyaletleri ve sonuç retrieval.
Bu sayfada
OAuth, Codex, OpenClaw Ve ve API-key erişim seçenekleri
MCP müşterinizi seçin ve bağlantı kurun
Ulaşım ve kimlik doğrulama
MCP endpoint barındırdığı nokta, Streamable HTTP kullanır. API-key bağlantıları X-API-Key gönderir; araç girişi anahtarın kaynak izinlerini ve mevcut kredileri takip eder.
URL: https://data.flashdata.dev/mcp
X-API-Key: < Your API key>Gerçek FlashData API anahtarını müşterinin şifreli konfigürasyonunda. Bunu bir konuşma veya araç tartışmalarına koymayın. Bu bölüm kapsar API-key bağlantıları; ajan erişim rehberi kapakları OAuth Giriş ve test Codex Ve ve OpenClaw konfigürasyonlar. youtube_download Uygun bir medya indirmelerini uygun şekilde destekler API-key izni.
API anahtarlarını yönetinSorgu araçları
Müşteriniz anahtar tarafından verilen araçları keşfeder. Tüm altı Google ve sekiz YouTube veri araçları gerçek zamanlı olarak varsayılan olarak doğrulanabilir ve ayrıca mode: async. submit_batch hem gruplar hem de youtube_download, resmi Download API, müşteri depolamasını sağlar ve aynı zamanda submit_batch'u destekler. Model görev için araçları seçebilir ve birleştirebilir.
google_search · google_images · google_news · google_shopping · google_videos · google_places
YouTube
youtube_search · youtube_search_extended · youtube_metadata · youtube_transcript · youtube_captions · youtube_trainability · youtube_channel · youtube_suggestions · youtube_download
{
"query": "MCP protocol",
"num": 3,
"gl": "us",
"hl": "en",
"mode": "async"
}Tool arguments
query, num, language ve mode gibi sorgu alanlarını REST API içindeki params sarmalayıcısı olmadan doğrudan aracın arguments nesnesine koyun. Sorgu aracının adı kaynağı seçer; source yalnızca submit_batch girdileri için gerekir. API anahtarları ve callback_url araç argümanı değildir. Aşağıdaki JSON örnekleri client.callTool({ name, arguments }) için argüman nesneleridir.
JSON booleans ve tam sayılar kullanın, dizeler değil. Bilinmeyen alanlar reddedilir. 14 veri sorgu araçları mode: realtime veya async, gerçek zamanlı olarak varsayılan olarak kabul eder. Batch girişleri modu kabul etmiyor.
| Tool Tool Tool | Zorunlu | Seçmeli argümanlar ve varsayılanlar |
|---|---|---|
youtube_download | video_id, storage | mod sadece (default) async destekler. download_type: audio_video (default)/video/audio. video_quality: <=720 varsayılan olarak; best/worst veya <=, ==, >= with with with ile 144/360/480/720/1080/1440/2160/4320. fps: Aynı karşılaştırmalar 1–240. output_format: mp4 (default)/webm/mkv Video için m4a (default)/mp3/opus Ses için. audio_language: default/original; audio_quality: best/320/256/192/128Ancak ses sadece. yt_dlp_format: yukarı 1024 karakterler, overrides kalitesi, fps ve dil seçimi. Omit video_quality/fps Ses ve ses için audio_language Video için sadece. depolama gereklidir ve indirmek Download API params.storage. start_at/end_at: HH:MM:SS, yukarı 12 saatler; end_at Takip etmek gerekir start_at. upload_metadata: boolean, varsayılan false. Her toplu indirme depolamaya ihtiyaç duyar. Hayır yok hayır browser_delivery veya callback_url. |
storage | storage_type, storage_url | storage_url Senin kovan adı (Azure: konteyner), yerel bir dizi değil. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tosSeçmeli olarak; object_prefix. S3, S3- uyumlu, OSS, COS, BOS ve TOS kullanımı access_key/secret_key Uygulandığı şekilde region/endpoint_url. GCS Kullanım kullanım kullanımı kullanır service_account (project_id, client_email, private_key); Azure Kullanım kullanım kullanımı kullanır account_name Ve bir konteyner sas_token Yaz izni ile. Son nokta, Worker'den erişilebilir olmalıdır. Depolama yapılandırmanızdan gelen kimlikleri okuyun; onları sohbete ya da yankıya sokmayın. |
google_* | query | Soru: 1–2,000 Karakterler. gl: iki-letter ülke; hl: 1–35 Karakter dili kodu; location/tbs: 1–200 karakterler; num/page: Fulls 1–100; autocorrect: boolean. Omized seçenekleri, arama sağlayıcının davranışını, sabit bir ülke, dil veya sonuç hesabı garanti etmediği ile kullanır. |
youtube_search | query | Soru: 1–2,000 karakterleri. max_results: 1–20, varsayılan 20; filtreler: filtre nesnesi, omed veya null |
youtube_search_extended | query | Soru: 1–2,000 karakterleri. max_results: 1–700, varsayılan 20; filtreler aynı standart arama. |
youtube_metadata | video_id | include_formats ve include_chapters: booleans, hem varsayılan true. |
youtube_transcript | video_id | Omit dili en-orig tercih etmek için, sonra bir takip edin. Auto=true ile, her kod onun -veyaig takipini tercih eder, sonra düz kod; açık -veyaig ve otomatik =false tam olarak kalır. Diziler tüm 1–10 talep edilen diller ve geri dönüş rotaları ve hataları sırayla deneyin. otomatik satırlar için true'ye otomatik satırlar için. |
youtube_captions | video_id | Omit dili en-orig tercih etmek için, sonra bir takip edin. Auto=true ile, her kod onun -veyaig takipini tercih eder, sonra düz kod; açık -veyaig ve otomatik =false tam olarak kalır. Diziler tüm 1–10 talep edilen diller ve geri dönüş rotaları ve hataları sırayla deneyin. false'ye yükleyici ayarlar için otomatik varsayılan yükler. |
youtube_trainability | video_id | mod dışında opsiyonel tartışmalar yok. Raporlar Creative Commons lisans sınıflandırması; eğitim izni vermiyor. |
youtube_channel | handle | Bölüm: 1–100 karakterleri; video_limit: 1–100, varsayılan 20. |
youtube_suggestions | query | Soru: 1–2,000 karakterleri; dil: varsayılan en; bölge: iki harfli ülke kodu, varsayılan ABD. |
video_id Bir an 11-character YouTube ID Mektupları, sayıları, alt noktaları veya hipnozları kullanarak; tedarik edin ID Videodan ziyade URL. Her dil kodu 1–35 karakterleri harfler, sayılar veya hipnozları kullanıyor. Subtitles için, auto=true otomatik satırları ve false, yüklemeleyici-provided captions'leri seçin, aralarında otomatik bir düşüş olmadan. Dil dizileri için, iş başarılı olduğunda bile hataları kontrol edin.
YouTube arama filtreleri
filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; süresi: <4, 4-20 veya >20; sort_by: rating/relevance/view_count/upload_date. Özel bayraklar booleans; true bu özelliği gerektirir: 360, 3d, 4k, creative_commons, HD, HD, HD, canlı, yer, satın alındı, alt başlıklar, vr180.
{
"query": "renewable energy",
"max_results": 5,
"filters": {
"type": "video",
"duration": "<4",
"subtitles": true
}
}Hesap öngörüleri (free)
get_balance Paylaşılan hesap bakiyenizi okur; get_pricing Tahminler sorgu maliyetleri; get_limits Plan limitleri ve şu anki iş bekleyen işleri okur; get_usage Sonuncuyu özetliyor 7 Varsayılan olarak, maksimum süre ile 31-gün pencere. Kullanım, arama anahtarı tarafından yetkili kaynaklar için tüm hesap anahtarlarını içerir ve gecikebilir.
get_balance ve get_limits {} alır. get_pricing isteğe bağlı source alır; anahtarınızın yetkili olduğu tüm MCP sorgu kaynakları için bu alanı atlayın. request_count, 1 ile 100000 arasında bir tam sayıdır; varsayılan 1 olur. Her sayfa veya batch öğesi ayrı istek sayılır. get_usage isteğe bağlı source alır; tüm yetkili kaynaklar için alanı atlayın. youtube_download kullanımı da dahildir. Download fiyatlandırması creditsPerTb döndürür (1 TB = 10^12 bayt). İndirmelerde kredi ayrılır ve ücret gerçekten yüklenen bayt miktarına göre kesinleşir. request_count indirmeler için geçerli değildir; estimatedCredits null olur.
get_usage from/to UTC ISO zamantamps gibi olması gerekir 2026-09-21T00:00:00Z, isteğe bağlı olarak 1–3 Kesik ikinci basamaklar. dahil olmak üzere, özel olarak, dakikalara kadar yuvarlanır. Varsayılan pencere 7 gün ve maksimum 31 gün. Sadece, yedi gün sonra; sadece yedi gün önce olduğu gibi. Cevabın from/to'u etkili pencere için okuyun.
{
"source": "google_search",
"request_count": 3
}{
"source": "youtube_metadata",
"from": "2026-09-21T00:00:00Z",
"to": "2026-09-22T00:00:00Z"
}Jobs ve büyük sonuçlar
Bir async isteği bir iş id döndürür; job_id ile get_job'u okumak için job.status'yu geç. Tamamlanan işler, çıktıdaki orijinal sorgu yanıtını içerir. İndirmeler için, çıktı ortaya çıkıyor: output.results[0].file_url müşteri depolama noktalarına, file_size, downloaded_bytes ve md5 ile. Özel dosyalar depolama doğrulamanızı gerektirir. JSON Sonuçlar için muhafaza edilir 24 Saatler; medya tutma ve erişim depolama politikalarını takip edin. submit_batch En azından bir tane kabul Google veya veya veya YouTube Soru ( indirmeler dahil), her girişte kaynak ve düz tartışmalarla. Her giriş ayrı olarak faturalanır ve planınızın toplu ve bekleme sınırları geçerlidir. Okuma işleri tekrar şarj etmiyor. Dosya tabanlı Bulk bir MCP aracı değildir.
Bir ID dosyasını işlemek? Kullanımı Kullanın Bulk HTTP API
{
"video_id": "FUfGcZ092b0",
"language": "en",
"auto": true,
"mode": "async"
}{
"queries": [
{
"source": "google_search",
"query": "renewable energy",
"num": 3
},
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"include_formats": false
}
]
}Örneğin job_id, result_id ve cevabınızdan değerlerle dengelemek. Soruyu yeniden göndermeden bir sonraki chunk'ı okuyun.
{
"job_id": "job_REPLACE_WITH_RETURNED_ID"
}Büyük cevaplar, acıklı bir yanıt içerir JSON Text chunk, result_id Ve ve next_offset. Call Call Çağrı get_result Aynı anahtarla ve geri döndü result_id. dengeleme, nonnegative tamsayıdır, varsayılan 0Önceki İçerikleri Kullanın next_offset Devam etmek için. limit tam bir tamsayı 1 To to to to için 16000, varsayılan 16000UTF-16 Kod birimleri astes veya sonuç satırları yerine. Parsing yapmadan önce kıkırıklar JSON; next_offset=null Sonunda işaret eder. Sonuçlar 10 dakikaları için önbelleklenir ve anahtar başına en çok dört büyük sonuçla birlikte, erken tahliye edilebilir. Reading chunks sorguyu veya şarj kredilerini tekrarlamaz.
{
"result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
"offset": 16000,
"limit": 16000
}Billing ve hataları
Queries mevcut planın kredilerini ek MCP şarjı olmadan kullanıyor. Araç hataları isError'u ayarlar ve HTTP statüsünü korur ve ID'u talep eder. Kredileri yetersiz denge için geri yükleyin ve erişim hataları için anahtar izinleri kontrol edin.
Bir süre boyunca veya kayıp bir bağlantı, sorgunun uygulanmadığı anlamına gelmez. query_outcome_unknown için, tekrar göndermeye karar vermeden önce konsolda History'u kontrol edin. Otomatik olarak ücretli teslimler yapmayın; mevcut işlerin veya chunksların okunması yeniden kullanılabilir. Upstream yanıtları 4 MiB ile sınırlıdır, bu yüzden arama büyüklüğü; uzun metler zaten şarj edilebilir.
Bir JavaScript müşteri ile doğrulayın
Bu müşteri doğrulanmış resmi SDK 1.30.0'u, ücretli bir sorgu olmadan Streamable HTTP ve liste araçlarına bağlanmak için kullanır. mcp-check.mjs olarak tasarruf edin, FLASHDATA_API_KEY'u çevrenizde ayarlar, sonra mcp-check.mjs'u çalıştırın.
npm install @modelcontextprotocol/[email protected]import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new Client({ name: 'my-app', version: '1.0.0' });
try {
await client.connect(new StreamableHTTPClientTransport(
new URL('https://data.flashdata.dev/mcp'),
{ requestInit: { headers: { 'X-API-Key': key } } }
));
console.log((await client.listTools()).tools.map(tool => tool.name));
} finally {
await client.close();
}