İçeriğe geç
TR
API anahtarı al
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

Markdown sürümü

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.

Akışkan HTTP
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önetin

Sorgu 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

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

google_search · argümanlar JSON
{
  "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 ToolZorunluSeçmeli argümanlar ve varsayılanlar
youtube_downloadvideo_id, storagemod 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.
storagestorage_type, storage_urlstorage_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_*querySoru: 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_searchquerySoru: 1–2,000 karakterleri. max_results: 1–20, varsayılan 20; filtreler: filtre nesnesi, omed veya null
youtube_search_extendedquerySoru: 1–2,000 karakterleri. max_results: 1–700, varsayılan 20; filtreler aynı standart arama.
youtube_metadatavideo_idinclude_formats ve include_chapters: booleans, hem varsayılan true.
youtube_transcriptvideo_idOmit 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_captionsvideo_idOmit 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_trainabilityvideo_idmod dışında opsiyonel tartışmalar yok. Raporlar Creative Commons lisans sınıflandırması; eğitim izni vermiyor.
youtube_channelhandleBölüm: 1–100 karakterleri; video_limit: 1–100, varsayılan 20.
youtube_suggestionsquerySoru: 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.

youtube_search · argümanlar JSON
{
  "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.

get_pricing · argümanlar JSON
{
  "source": "google_search",
  "request_count": 3
}
get_usage · argümanlar JSON
{
  "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

youtube_transcript · argümanlar JSON
{
  "video_id": "FUfGcZ092b0",
  "language": "en",
  "auto": true,
  "mode": "async"
}
submit_batch · argümanlar JSON
{
  "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.

get_job · argümanlar JSON
{
  "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.

get_result · argümanlar JSON
{
  "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.

Temel HTTP statüsü kodları · Retry kuralları

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
npm install @modelcontextprotocol/[email protected]
mcp-check.mjs
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();
}