Dokumentation durchsuchen
Erste Schritte
Geben Sie Ihrem Agenten Google Search und YouTube Tools. Verbinden Sie Ihren Gastgeber und fragen Sie nach Ihrem ersten Ergebnis.
Auf dieser Seite
1. Verbinden und anmelden
Wählen Sie Codex oder OpenClaw für browserbasiertes OAuth. Wählen Sie für einen anderen Host den Remote / API-Schlüssel, wenn er Streamable HTTP und benutzerdefinierte Header unterstützt, oder Local / stdio, wenn er MCP-Prozesse startet. Der Hosted Server benötigt keine lokale Installation.
Fügen Sie die Konfiguration unten in ~/.codex/config.toml zusammen und führen Sie dann den Login-Befehl aus. Komplette FlashData-Anmeldung oder -Anmeldung und Zustimmung im Browser. Starten Sie eine neue Codex-Sitzung nach dem Login.
[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:researchFühren Sie diese Befehle im OpenClaw-Profil aus, das Ihr Agent verwendet. Vollständige Anmeldung oder Anmeldung und Zustimmung im Browser, dann starten Sie eine neue Sitzung. Die Arztsonde überprüft die gespeicherte Verbindung.
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 --probeErstellen Sie einen Schlüssel mit der Google Search-Berechtigung oder verwenden Sie einen erneut. Fügen Sie einen Server in den MCP-Einstellungen Ihres Hosts mit den folgenden Feldern hinzu. Legen Sie den Schlüssel in sein geschütztes Header-Feld und verbinden Sie es erneut; es wird kein OAuth-Befehl benötigt.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYErfordert Node.js 22.18+ und einen API Schlüssel mit Google Search Berechtigung. Fügen Sie dies zu einem Host zusammen, der mcpServers JSON unterstützt. Ersetzen Sie YOUR_API_KEY in seiner lokalen geschützten Konfiguration und starten Sie dann den Host neu. Verwenden Sie npx.cmd auf Windows, wenn der Host einen ausführbaren Dateinamen benötigt.
Das angeheftete npm-Paket führt den lokalen MCP-Server aus. Die eigenständige FlashData CLI ist eine separate ausführbare Datei.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. Überprüfen Sie die Verbindung
Senden Sie dies in einer frischen Agentensitzung. Erwarten Sie erfolgreiche get_pricing und get_balance Anrufe, einen verfügbaren Preis für google_search und Ihr verfügbares Guthaben. Ein Nullsaldo bedeutet, dass Sie Credits für die Suche benötigen; es bedeutet nicht, dass die Authentifizierung fehlgeschlagen ist.
Verwenden Sie die vorhandene Flashdata MCP-Verbindung.
Rufen Sie get_pricing mit {"source":"google_search","request_count":1} an.
Rufen Sie get_balance mit {} an.
Geben Sie an, ob beide Anrufe erfolgreich waren, ob die Quelle einen verfügbaren Preis hat;
und den verfügbaren Kreditsaldo. Ein Nullsaldo ist kein Authentifizierungsfehler.
Führen Sie keine Suche aus oder laden Sie sie herunter, erstellen Sie eine Testversion oder ändern Sie Ihre Anmeldeinformationen.3. Fragen Sie nach Ihrer ersten Aufgabe
Fügen Sie dies in Ihren Connected Agent ein. Die Saldo- und Preisprüfungen sind kostenlos; Die Suche verwendet Kontogutschriften.
Verwenden Sie FlashData, um mein Guthaben und den Preis einer Google-Suche zu überprüfen. Wenn genügend Credits vorhanden sind, rufen Sie google_search einmal mit der Abfrage "battery recycling research", num 5 und Modus "realtime" auf. Rückgabetitel, Quelle URLs, kurze Auszüge und tatsächliche Credits verwendet. Stoppen Sie nach dieser Aufgabe.Ergebnis prüfen
Ihr Agent sollte Quellenlinks und Auszüge sowie die tatsächlich verwendeten Credits zurückgeben. Das zugrunde liegende Suchergebnis hat status: done und results[].organic. Ein leeres Ergebnis ist gültig; der Agent sollte es melden. Das folgende Beispiel ist illustrativ.
Eine Google Suche abgeschlossen.
1. Batterierecyclingforschung — https://example.org/recycling
Ein Beispiel-Suchauszug.
Verwendete Credits: 0.02Verfügbare Werkzeuge
API-Schlüsselaufrufe verwenden die Berechtigungen, die diesem Schlüssel gewährt wurden. Entdecken Sie die Tools und Eingabeschemata des Servers für den vollständigen aktuellen Katalog.
| Aufgabe | Werkzeug | Zugang |
|---|---|---|
| Suche nach Google | google_search | mcp:research / API key |
| Finden Sie YouTube Videos | youtube_search | mcp:research / API key |
| Video-Metadaten lesen | youtube_metadata | mcp:research / API key |
| Bestehende Bildunterschriften abrufen | youtube_transcript | mcp:research / API key |
| Herunterladen von Video oder Audio | youtube_download | Besitzer API Schlüssel + Zielspeicherung |
| Konto prüfen und Preisgestaltung | get_balance, get_pricing, get_limits, get_usage | Kostenloses Konto liest |
Über OAuth, Berechtigungen und Testversionen
OAuth verbindet Ihr verifiziertes Besitzerkonto und lässt den Host Token speichern und aktualisieren. Der mcp:research-Zuschuss deckt die vier oben genannten Forschungsquellen ab. API-Schlüsselverbindungen verwenden einen geschützten X-API-Key-Header und können andere autorisierte Quellen enthalten.
Um FlashData auszuprobieren, bevor Sie ein Konto erstellen, verwenden Sie den Testablauf von CLI. MCP OAuth verbindet ein Besitzerkonto; es registriert oder beansprucht keine Testversion. Ein CLI-Profil wird nicht automatisch mit Ihrem MCP-Host geteilt.
Fehlerbehebung
| Problem | Probieren Sie dies aus |
|---|---|
| Keine FlashData-Tools | Beenden Sie die Zustimmung, verbinden Sie sich wieder und starten Sie eine neue Sitzung. Überprüfen Sie den URL und den Streamable HTTP Transport. |
| invalid_client / callback error | Verwenden Sie für Codex oder OpenClaw die genaue Clientkonfiguration und einen Browser, der den lokalen Rückruf erreichen kann. Verwenden Sie für einen anderen Host die oben genannte API-Taste oder Stdio-Einrichtung. |
| 401 | Der OAuth-Zugriff wurde erneut verbunden oder widerrufen, oder überprüfen Sie den API-Schlüssel, der dem Host zugeführt wurde. Wiederholen Sie den kostenlosen Check. |
| 403 | Überprüfen Sie die angeforderten Quell- und Schlüsselberechtigungen. YouTube Download erfordert einen Besitzer-API-Schlüssel mit youtube_download und Zielspeicherung; mcp:research enthält ihn nicht. |
| 402 | Überprüfen Sie Billing und den aktuellen Preis. Das Wiederverbinden eines gültigen Anmelders fügt keine Credits hinzu. |
| 429 | Folgen Sie Retry-After. Behalten Sie einen vorhandenen Job oder ein Ergebnis ID, bevor Sie entscheiden, ob Sie die Aufgabe erneut versuchen möchten. |
| Timeout oder unvollständige Antwort | Behalten Sie die Anforderung ID und überprüfen Sie History. Lesen Sie Fortsetzungen mit großem Ergebnis mit get_result, anstatt die Suche zu wiederholen. |