Documentatie bekijken
Aan de slag
Geef uw agent Google Search en YouTube tools. Sluit uw host aan en vraag dan om uw eerste resultaat.
Op deze pagina
1. Verbinden en aanmelden
Kies Codex of OpenClaw voor browser-gebaseerde OAuth. Voor een andere host, kies Remote / API sleutel als het streamable HTTP en aangepaste headers ondersteunt, of Lokale / stdio als het MCP processen start. De gehoste server heeft geen lokale installatie nodig.
Voeg de configuratie hieronder samen in ~/.codex/config.toml en voer vervolgens het aanmeldcommando uit. Complete FlashData aanmelding of aanmelding en toestemming in de browser. Start een nieuwe Codex sessie na inloggen.
[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:researchVoer deze commando's uit in het OpenClaw-profiel dat uw agent gebruikt. Volledige aanmelding of aanmelding en toestemming in de browser, start dan een nieuwe sessie. De dokter onderzoekt de opgeslagen verbinding.
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 --probeMaak een sleutel aan met Google Search-permissie, of hergebruik er een. Voeg een server toe aan de MCP-instellingen van uw host met onderstaande velden. Plaats de sleutel in het beveiligde headerveld en herverbinding; er is geen OAuth commando nodig.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYVereist Node.js 22.18+ en een API sleutel met Google Search toestemming. Dit samenvoegen tot een host die mcpServers JSON ondersteunt. Vervang YOUR_API_KEY in zijn lokale beveiligde configuratie en herstart de host. Gebruik npx.cmd op Windows als de host een uitvoerbare bestandsnaam nodig heeft.
Het gepinde npm pakket draait op de lokale MCP server. De standalone FlashData CLI is een apart uitvoerbaar bestand.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. Controleer de verbinding
Stuur dit in een nieuwe agent sessie. Verwacht succesvolle get_pricing en get_balance-gesprekken, een beschikbare prijs voor google_search en uw beschikbare kredietsaldo. Een nulbalans betekent dat je credits nodig hebt voor de zoekopdracht; het betekent niet dat authenticatie mislukt is.
Gebruik de bestaande flashdata MCP-verbinding.
Bel get_pricing met {"source":"google_search","request_count":1}.
Bel get_balance met {}.
Rapporteren of beide oproepen zijn geslaagd, of de bron een beschikbare prijs heeft,
en het beschikbare kredietsaldo. Een nulbalans is geen authenticatiefout.
Voer geen zoekopdracht of download uit, maak een proefversie aan of wijzig de referenties.3. Vraag naar je eerste taak
Plak dit in je verbonden agent. Het saldo en de prijscontroles zijn gratis; de zoekopdracht maakt gebruik van rekeningkredieten.
Gebruik FlashData om mijn saldo en de prijs van een Google zoekopdracht te controleren. Als er genoeg credits zijn, bel dan eens google_search met query "battery recycling research", num 5 en mode "realtime". Geef titels, bron URLs, korte fragmenten en werkelijke credits gebruikt. Stop na deze taak.Het resultaat controleren
Je agent moet bronlinks en fragmenten teruggeven, plus de gebruikte credits. Het onderliggende zoekresultaat heeft status: done en results[].organic. Een leeg resultaat is geldig; de agent moet het melden. Het voorbeeld hieronder is illustratief.
Een Google-zoekopdracht voltooid.
1. Onderzoek naar de recycling van accu's https://example.org/recycling
Een voorbeeld zoekfragment.
Gebruikte kredieten: 0.02Beschikbare instrumenten
API-key calls gebruiken de rechten die aan die sleutel zijn verleend. Ontdek de tools van de server en invoerschema's voor de volledige huidige catalogus.
| Taak | Hulpmiddel | Toegang |
|---|---|---|
| Google doorzoeken | google_search | mcp:research / API key |
| Zoek YouTube video's | youtube_search | mcp:research / API key |
| Videometadata lezen | youtube_metadata | mcp:research / API key |
| Bestaande bijschriften ophalen | youtube_transcript | mcp:research / API key |
| Video of audio downloaden | youtube_download | Eigenaar API sleutel + bestemmingsopslag |
| Account en prijzen controleren | get_balance, get_pricing, get_limits, get_usage | Gratis account leest |
Over OAuth, machtigingen en proeven
OAuth verbindt uw geverifieerde eigenaar account en laat de host store en verfrissen tokens. De mcp:research-subsidie heeft betrekking op de vier bovengenoemde onderzoeksbronnen. API-sleutelverbindingen maken gebruik van een beschermde X-API-Key-header en kunnen andere geautoriseerde bronnen bevatten.
Om FlashData te proberen voordat u een account aanmaakt, gebruikt u de CLI trial flow. MCP OAuth verbindt een eigenaaraccount; het registreert of claimt geen proefversie. Een CLI-profiel wordt niet automatisch gedeeld met uw MCP-host.
Problemen oplossen
| Probleem | Probeer dit eens |
|---|---|
| Geen FlashData-gereedschappen | Voltooi toestemming, opnieuw verbinden en start een nieuwe sessie. Controleer het URL en streamable HTTP transport. |
| invalid_client / callback error | Voor Codex of OpenClaw, gebruik de exacte configuratie van de client en een browser die de lokale callback kan bereiken. Voor een andere host, gebruik de ondersteunde API-toets of stdio-instellingen hierboven. |
| 401 | Vervallen of ingetrokken OAuth-toegang opnieuw verbinden, of de API-sleutel controleren die aan de host wordt geleverd. Herhaal de gratis cheque. |
| 403 | Controleer de gevraagde bron en sleutelrechten. YouTube Download vereist een eigenaar API sleutel met youtube_download en bestemmingsopslag; mcp:research bevat deze niet. |
| 402 | Controleer Billing en de huidige prijs. Het opnieuw verbinden van een geldige credential voegt geen credits toe. |
| 429 | Volg Retry-After. Houd een bestaande baan of resultaat ID voordat u beslist of u de taak opnieuw wilt proberen. |
| Timeout of onvolledig antwoord | Houd de aanvraag ID en controleer History. Lees grote resultaten met get_result in plaats van de zoekopdracht te herhalen. |