Sfoglia la documentazione
Riferimento API
Strumenti e schemi MCP
Cerca gli argomenti degli strumenti FlashData MCP, i default, le letture degli account, gli stati di lavoro e il recupero dei risultati.
In questa pagina
OAuth, Codex, OpenClaw e API-chiave opzioni di accesso
Scegli il tuo client MCP e collega
Trasporti e autenticazione
L'endpoint MCP ospitato utilizza Streamable HTTP. Le connessioni API-chiave inviano X-API-Key; l'accesso agli strumenti segue le autorizzazioni di origine della chiave e i crediti disponibili.
URL: https://data.flashdata.dev/mcp
X-API-Key: <your API key>Memorizza la tua chiave FlashData API nella configurazione delle credenziali del client. Non mettere in una conversazione o argomenti di strumento. Questa sezione riguarda le connessioni API-chiave; la guida di accesso dell'agente copre il login OAuth e le configurazioni Codex e OpenClaw. youtube_download supporta i download dei supporti asincroni con l'apposita autorizzazione API-chiave.
Gestione delle chiavi APIStrumenti di query
Il vostro cliente scopre gli strumenti concessi dalla chiave. Tutti i sei strumenti di dati Google e otto YouTube di default in tempo reale e anche accettare mode: async. submit_batch supporta entrambi i gruppi. youtube_download utilizza il download formale API, richiede l'archiviazione del cliente, e supporta i lavori asincroni o submit_batch. Il modello può scegliere e combinare gli strumenti per l'attività.
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"
}Argomenti degli strumenti
Metta campi di query come query, num, lingua e modalità direttamente nell'oggetto argomenti dello strumento, senza l'involucro di params di REST API. Il nome di uno strumento di query seleziona la sua fonte; solo le voci nella fonte di bisogno di submit_batch. Le chiavi API e callback_url non sono argomenti di strumento. Gli esempi JSON di seguito sono oggetti di argomento per client.callTool({ nome, argomenti }).
Utilizzare i booleani e i numeri interi di JSON, non le stringhe. I campi sconosciuti sono respinti. Gli strumenti di query dati 14 accettano mode: realtime o asincroni, predefiniti in tempo reale. Le voci Batch non accettano la modalità.
| Strumento | Obbligatorio | Argomenti e default opzionali |
|---|---|---|
youtube_download | video_id, storage | la modalità supporta solo asincroni (default). download_type: audio_video (default)/video/audio. video_quality: <=720 per impostazione predefinita; best/worst # Con # 144/360/480/720/1080/1440/2160/4320. fps: gli stessi confronti con 1–240. output_format: mp4 (default)/webm/mkv per video, m4a (default)/mp3/opus per audio. audio_language: default/original; audio_quality: best/320/256/192/128Solo audio. yt_dlp_format: fino a raggiungere 1024 caratteri, supera la qualità, fps e la selezione della lingua. Omissione video_quality/fps per audio e audio_language per il solo video. è necessario lo storage e le partite Scarica API params.storage. start_at/end_at: HH:MM:SS, fino a 12 ore; end_at deve seguire start_at. upload_metadata: boolean, default false. Ogni lotto di download ha bisogno di archiviazione. No browser_delivery o callback_url. |
storage | storage_type, storage_url | storage_url è il tuo nome di secchio (Azure: contenitore), non una directory locale. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; opzionali object_prefix. S3, compatibile con S3, OSS, COS, BOS e TOS utilizzano access_key/secret_key con region/endpoint_url. applicabile GCS utilizza service_account (project_id, client_email, private_key); Azure utilizza account_name e un contenitore sas_token con il permesso di scrittura. Il punto finale deve essere raggiungibile dal lavoratore. Leggere le credenziali dalla configurazione di archiviazione; non incollarle in chat o eco. |
google_* | query | query: 1–2,000 caratteri. gl: paese a due lettere; hl: 1–35 codice di lingua del personaggio; location/tbs: 1–200 caratteri; num/page: integers 1–100; autocorretto: booleano. Le opzioni omesse utilizzano il comportamento del provider di ricerca, senza un paese fisso, un numero di lingua o di risultati garantiti. |
youtube_search | query | query: 1–2,000 caratteri. max_results: 1–20, default 20; filtri: oggetto filtrante, omesso o null per nessun filtro. |
youtube_search_extended | query | query: 1–2,000 caratteri. max_results: 1–700, default 20; filtri: stesso della ricerca standard. |
youtube_metadata | video_id | include_formats e include_chapters: booleans, entrambi di default true. |
youtube_transcript | video_id | Omit lingua per preferire en-orig, poi en, restituire una traccia. Con auto=true, ogni codice preferisce la sua -orig traccia, quindi il codice normale; -orig esplicito e auto=false rimangono esatti. Arrays prova tutto 1–10 lingue richieste e tracce di ritorno ed errori in ordine. auto default a true per didascalie automatiche. |
youtube_captions | video_id | Omit lingua per preferire en-orig, poi en, restituire una traccia. Con auto=true, ogni codice preferisce la sua -orig traccia, quindi il codice normale; -orig esplicito e auto=false rimangono esatti. Arrays prova tutto 1–10 lingue richieste e tracce di ritorno ed errori in ordine. auto default a false per le didascalie fornite dal caricatore. |
youtube_trainability | video_id | Nessun argomento facoltativo tranne la modalità. Rapporti Creative Commons classificazione di licenza; non concede il permesso di formazione. |
youtube_channel | handle | maniglia: 1–100 caratteri; video_limit: 1–100, default 20. |
youtube_suggestions | query | query: 1–2,000 caratteri; lingua: default en; regione: codice paese a due lettere, USA predefinito. |
video_id è un 11-character YouTube ID che utilizza lettere, numeri, underscore o iphens; fornisce lo ID piuttosto che il video URL. Ogni codice di lingua è 1–35 caratteri utilizzando lettere, numeri o iphens. Per i sottotitoli, l'auto=true seleziona le didascalie automatiche e false seleziona le didascalie provviste di uploader, senza ricadute automatiche tra di loro. Per gli array linguistici, controllare gli errori anche quando il lavoro riesce.
YouTube filtri di ricerca
filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; durata: <4, 4-20 o >20; sort_by: rating/relevance/view_count/upload_date. Le bandiere principali sono booleane; true richiede questa funzione: 360, 3d, 4k, creative_commons, hd, hdr, live, location, acquistato, sottotitoli, vr180.
{
"query": "renewable energy",
"max_results": 5,
"filters": {
"type": "video",
"duration": "<4",
"subtitles": true
}
}Intuizioni account (gratuito)
get_balance legge il saldo del tuo account condiviso; get_pricing stima i costi di query; get_limits legge i limiti di piano e i lavori in sospeso correnti; get_usage riassume gli ultimi giorni 7 per impostazione predefinita, con una finestra massima 31-giorno. L'uso include tutte le chiavi dell'account per le fonti autorizzate dalla chiave di chiamata e può essere ritardato.
get_balance e get_limits Prendi {}. get_pricing accetta una fonte facoltativa; ometterla per tutti MCP fonti di query autorizzate dalla vostra chiave. request_count è un intero da 1 a 100000, default 1; ogni pagina o elemento lotto conta come una richiesta separata. get_usage accetta una fonte facoltativa; ometterla per tutte le fonti autorizzate. Esso include l'uso youtube_download. Scarica i resoconti dei prezzi creditsPerTb (1 TB = 10^12 bytes); scarica i crediti di riserva e si stabiliscono da byte caricate reali. request_count non si applica ai download e estimatedCredits è null.
get_usage from/to deve essere timestamp UTC ISO come 2026-09-21T00:00:00Z, opzionalmente con 1–3 secondo cifre frazionarie. La finestra di default è 7 giorni e il massimo è 31 giorni. Con solo da, a è sette giorni dopo; con solo a, da è sette giorni prima. Leggi from/to della risposta per la finestra efficace.
{
"source": "google_search",
"request_count": 3
}{
"source": "youtube_metadata",
"from": "2026-09-21T00:00:00Z",
"to": "2026-09-22T00:00:00Z"
}Lavori e risultati grandi
Una richiesta asincrona restituisce un lavoro id; passarlo come job_id a get_job per leggere job.status. I lavori completi includono la risposta di query originale in uscita. Per i download, l'output è il manifesto di caricamento: output.results[0].file_url punti alla memorizzazione del cliente, con file_size, downloaded_bytes e md5. I file privati richiedono l'autenticazione di archiviazione. I risultati JSON sono conservati per le ore 24; la ritenzione e l'accesso dei media seguono le politiche di archiviazione. submit_batch accetta almeno una query Google o YouTube (compresi i download), con argomenti di origine e piana su ogni voce. Ogni voce viene fatturata separatamente, e il lotto del vostro piano e i limiti in sospeso si applicano. I lavori di lettura non fanno pagare di nuovo. Bulk non è uno strumento MCP.
Elaborazione di un file ID? Utilizzare 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
}
]
}Sostituire l'esempio job_id, result_id e compensare con i valori della risposta. Leggi il prossimo pezzo senza rispedire la query.
{
"job_id": "job_REPLACE_WITH_RETURNED_ID"
}Le grandi risposte includono un pezzo di testo JSON, result_id e next_offset. Chiamata get_result con la stessa chiave e il ritorno result_id. offset è un intero non negativo, predefinito 0; utilizzare il precedente next_offset per continuare. il limite è un intero da 1 a 16000, default 16000, misurato in UTF-16 unità di codice piuttosto che byte o righe di risultato. Concatena i pezzi in ordine prima di parsing JSON; next_offset=null segna la fine. I risultati sono memorizzati in cache per i minuti 10, con al massimo quattro grandi risultati per chiave, e possono essere sfrattati prima. I pezzi di lettura non ripetono la query o caricano i crediti.
{
"result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
"offset": 16000,
"limit": 16000
}Billing ed errori
Le query utilizzano i prezzi dei crediti del tuo piano esistente senza costi aggiuntivi di MCP. Gli errori degli strumenti impostano isError e mantengono lo stato HTTP e richiedono ID. Ripristinare Crediti per un equilibrio insufficiente e controllare le autorizzazioni chiave per gli errori di accesso.
Una connessione timeout o persa non significa che la query non è stata eseguita. Per query_outcome_unknown, controllare Richiedi History nella console prima di decidere di inviare di nuovo. Non rimproverare automaticamente le presentazioni retribuite; le letture dei lavori esistenti o dei pezzi possono essere rimessi in discussione. Le risposte a monte sono limitate a 4 MiB, quindi limitano la dimensione della ricerca; le risposte sovradimensionate potrebbero già essere state caricate.
Verificare con un client JavaScript
Questo client utilizza il funzionario verificato SDK 1.30.0 per connettersi a Streamable HTTP e elencare gli strumenti senza eseguire una query pagata. Salvalo come mcp-check.mjs, imposta FLASHDATA_API_KEY nel tuo ambiente, quindi esegui il nodo mcp-check.mjs.
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();
}