Documentatie bekijken
API-referentie
MCP-tools en schema’s
Zoek FlashData MCP gereedschapsargumenten, standaardwaarden, account leest, taaktoestanden en resultaatherstel op.
Op deze pagina
OAuth, Codex, OpenClaw en API-toets toegangsopties
Kies uw MCP-client en maak verbinding
Vervoer en authenticatie
Het gehoste MCP eindpunt maakt gebruik van streamable HTTP. API-sleutelverbindingen sturen X-API-Key; de toegang tot het gereedschap volgt de bronrechten en beschikbare credits van de sleutel.
URL: https://data.flashdata.dev/mcp
X-API-Key: <your API key>Bewaar uw FlashData API sleutel in de clients credential configuratie. Plaats het niet in een gesprek of gereedschapsargument. Deze sectie heeft betrekking op API-toetsen; de toegangshandleiding voor agent dekt de OAuth login en de geteste Codex en OpenClaw configuraties. youtube_download ondersteunt asynchrone media downloads met de juiste API-toets toestemming.
API-sleutels beherenHulpmiddelen voor opvragen
Uw klant ontdekt de tools die door de sleutel worden verleend. Alle zes Google en acht YouTube datatools zijn standaard in realtime en accepteren ook mode: async. submit_batch ondersteunt beide groepen. youtube_download gebruikt de formele Download API, vereist opslag van klanten, en ondersteunt async-taken of submit_batch. Het model kan tools voor de taak kiezen en combineren.
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"
}Hulpmiddelargumenten
Plaats queryvelden zoals query, num, taal en modus direct in het object met argumenten van het gereedschap, zonder de REST API Een query-tool selecteert de bron; alleen items in submit_batch hebben een bron nodig. API sleutels en callback_url zijn geen gereedschapsargumenten. De JSON voorbeelden hieronder zijn argument objecten voor client.callTool({ naam, argumenten }).
Gebruik JSON booleanen en gehele getallen, geen tekenreeksen. Onbekende velden worden afgewezen. De 14 data query tools accepteren mode: realtime of async, standaard voor real-time. Batch-items accepteren de modus niet.
| Hulpmiddel | Vereist | Facultatieve argumenten & standaard |
|---|---|---|
youtube_download | video_id, storage | mode ondersteunt alleen async (standaard). download_type: audio_video (standaard)/video/audio. video_quality: standaard <=720; best/worst of <=, ==, >= met 144/360/480/720/1080/1440/2160/4320. fps: dezelfde vergelijkingen met 1–240. output_format: mp4 (standaard)/webm/mkv voor video, m4a (standaard)/mp3/opus voor audio. audio_language: default/original; audio_quality: best/320/256/192/128, alleen voor audio. yt_dlp_format: maximaal 1024 tekens; overschrijft de keuze van kwaliteit, fps en taal. Laat video_quality/fps weg voor audio en audio_language voor video-only. storage is verplicht en komt overeen met params.storage van de Download API. start_at/end_at: HH:MM:SS, maximaal 12 uur; end_at moet na start_at liggen. upload_metadata: boolean, standaard false. Elke batchdownload vereist storage. browser_delivery en callback_url worden niet ondersteund. |
storage | storage_type, storage_url | storage_url is je emmernaam (Azure: container), geen lokale map. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; optioneel object_prefix. S3, S3-compatibel, OSS, COS, BOS en TOS gebruiken access_key/secret_key met de toepasselijke region/endpoint_url. GCS maakt gebruik van service_account (project_id, client_email, private_key); Azure gebruikt account_name en een container sas_token met schrijftoestemming. Het eindpunt moet bereikbaar zijn vanaf de werknemer. Lees referenties uit uw opslagconfiguratie; plak ze niet in een chat of echo. |
google_* | query | query: 1–2,000 karakters. gl: land met twee letters; hl: 1–35 karaktertaalcode; location/tbs: 1–200 tekens; num/page: gehele getallen 1–100; autocorrect: booleaans. Toegestaan opties gebruiken de zoekmachine gedrag, zonder vaste land, taal of resultaat gegarandeerd. |
youtube_search | query | query: 1–2,000 karakters. max_results: 1–20, standaard 20; filters: filter object, weggelaten of null voor geen filters. |
youtube_search_extended | query | query: 1–2,000 karakters. max_results: 1–700, standaard 20; filters: hetzelfde als standaard zoeken. |
youtube_metadata | video_id | include_formats en include_chapters: booleanen, beide standaard true. |
youtube_transcript | video_id | Taal naar voorkeur en-orig, dan en, terugsturen van een track. Met auto=true geeft elke code de voorkeur aan zijn -orig track, dan de platte code; expliciet -orig en auto=false blijft exact. Arrays probeer alle 1–10 opgevraagde talen en retourneren tracks en fouten in volgorde. auto standaards naar true voor automatische bijschriften. |
youtube_captions | video_id | Taal naar voorkeur en-orig, dan en, terugsturen van een track. Met auto=true geeft elke code de voorkeur aan zijn -orig track, dan de platte code; expliciet -orig en auto=false blijft exact. Arrays probeer alle 1–10 opgevraagde talen en retour tracks en fouten in volgorde. auto standaards naar false voor uploader-onderschriften. |
youtube_trainability | video_id | Geen optionele argumenten behalve modus. Rapporten Creative Commons licentie classificatie; het verleent geen training toestemming. |
youtube_channel | handle | handvat: 1–100 tekens; video_limit: 1–100, standaard 20. |
youtube_suggestions | query | query: 1–2,000 karakters; taal: default en; regio: tweeletterige landcode, standaard US. |
video_id is een 11-karakter YouTube ID met letters, cijfers, onderstrepingen of koppeltekens; levert de ID in plaats van de video URL. Elke taalcode is 1–35-tekens met letters, cijfers of koppeltekens. Voor ondertitels selecteert auto=true automatische ondertitels en false selecteert uploader-ondertitels, zonder automatische terugval. Voor taalarrays, controleer fouten zelfs wanneer de taak slaagt.
Zoekfilters YouTube
filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; duur: <4, 4-20 of >20; sort_by: rating/relevance/view_count/upload_date. Functie vlaggen zijn booleanen; true vereist die functie: 360, 3d, 4k, creative_commons, hd, hdr, live, locatie, gekocht, ondertitels, vr180.
{
"query": "renewable energy",
"max_results": 5,
"filters": {
"type": "video",
"duration": "<4",
"subtitles": true
}
}Account-inzichten (vrij)
get_balance leest uw shared account saldo; get_pricing schat de query kosten; get_limits leest planlimieten en lopende jobs; get_usage vat standaard de laatste 7 dagen samen, met een maximaal 31-dag venster. Gebruik omvat alle accountsleutels voor bronnen die zijn toegestaan door de aanroepsleutel en kan worden vertraagd.
get_balance en get_limits nemen {}. get_pricing accepteert een optionele bron; laat deze weg voor alle MCP-querybronnen die door uw sleutel zijn toegelaten. request_count is een geheel getal van 1 tot 100000, standaard 1; elke pagina of batch-item telt als een afzonderlijk verzoek. get_usage accepteert een optionele bron; laat het weg voor alle geautoriseerde bronnen. Het bevat youtube_download gebruik. Download pricing returns creditsPerTb (1 TB = 10^12 bytes); downloads reserveren Credits en regelen door werkelijke geüploade bytes. request_count is niet van toepassing op downloads en estimatedCredits is null.
get_usage from/to moeten UTC ISO-tijdstempels zijn, zoals 2026-09-21T00:00:00Z, optioneel met 1–3 fractionele tweede cijfers. van is inclusief, tot exclusief, afgerond naar beneden tot minuten. Het standaard venster is 7 dagen en het maximum is 31 dagen. Met slechts van, tot zeven dagen later; met slechts tot, van is zeven dagen eerder. Lees het antwoord from/to voor het effectieve venster.
{
"source": "google_search",
"request_count": 3
}{
"source": "youtube_metadata",
"from": "2026-09-21T00:00:00Z",
"to": "2026-09-22T00:00:00Z"
}Banen en grote resultaten
Een async-verzoek geeft een taak-id terug; geef het door als job_id aan get_job om job.status te lezen. Voltooide taken omvatten de oorspronkelijke query response in output. Voor downloads is output de upload manifest: output.results[0].file_url wijst naar de opslag van klanten, met file_size, downloaded_bytes en md5. Privé-bestanden vereisen uw opslagauthenticatie. JSON resultaten worden bewaard voor 24 uren; media-retentie en toegang volgen uw opslagbeleid. submit_batch accepteert ten minste één Google of YouTube query (inclusief downloads), met bron- en platte argumenten bij elke invoer. Elke ingang wordt afzonderlijk gefactureerd, en uw plan .. batch en in afwachting van beperkingen van toepassing zijn. Leesopdrachten worden niet meer opgeladen. Bestandsgebaseerde Bulk is geen MCP hulpmiddel.
Een ID-bestand verwerken? Gebruik de 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
}
]
}Vervang het voorbeeld job_id, result_id en offset met waarden uit je antwoord. Lees de volgende brok zonder de query opnieuw in te dienen.
{
"job_id": "job_REPLACE_WITH_RETURNED_ID"
}Grote antwoorden zijn onder andere een JSON tekstblok, result_id en next_offset. Bel get_result met dezelfde sleutel en de teruggekeerde result_id. offset is een niet-negatief geheel getal, standaard 0; gebruik de vorige next_offset om verder te gaan. limit is een geheel getal van 1 naar 16000, standaard 16000, gemeten in UTF-16 codeeenheden in plaats van bytes of resultaatrijen. Concatenate chunks in volgorde voordat JSON; next_offset=null het einde markeert. De resultaten zijn gecached voor 10 minuten, met maximaal vier grote resultaten per toets, en kan eerder worden uitgezet. Het lezen van brokken herhaalt niet de vraag of kosten Credits.
{
"result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
"offset": 16000,
"limit": 16000
}Billing en fouten
Queries gebruiken uw bestaande plan. Credits prijzen zonder extra MCP kosten. Gereedschapsfouten stellen isError in en behouden de upstream HTTP status en vragen om ID. Herstel Credits voor onvoldoende saldo en controleer sleutelrechten voor toegangsfouten.
Een timeout of verloren verbinding betekent niet dat de query niet is uitgevoerd. Voor query_outcome_unknown, controleer Aanvraag History in de console voordat u besluit om opnieuw in te dienen. Probeer niet automatisch betaalde inzendingen opnieuw; leest van bestaande banen of brokken kunnen worden opgehaald. Upstream responsen zijn beperkt tot 4 MiB, dus beperken zoekgrootte; oversized responses kunnen al zijn opgeladen.
Controleren met een JavaScript client
Deze client maakt gebruik van de geverifieerde officiële SDK 1.30.0 om verbinding te maken via streamable HTTP en list tools zonder een betaalde query. Bewaar het als mcp-check.mjs, stel FLASHDATA_API_KEY in in uw omgeving en voer vervolgens knooppunt mcp-check.mjs uit.
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();
}