Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

FlashData MCP

Dare al vostro agente Google Ricerca e strumenti YouTube. Collega il tuo host, quindi chiedi il tuo primo risultato.

In questa pagina

1. Collegare e firmare

Scegliere Codex o OpenClaw per il browser basato OAuth. Per un altro host, scegliere Remote / API chiave se supporta Streamable HTTP e intestazioni personalizzate, o Local / stdio se lancia processi MCP. Il server ospitato non ha bisogno di installazione locale.

Unire la configurazione qui sotto in ~/.codex/config.toml, quindi eseguire il comando di login. Completare l'iscrizione FlashData o l'accesso e il consenso nel browser. Avviare una nuova sessione Codex dopo il login.

config.toml
[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"
Accedi
codex mcp login flashdata --scopes mcp:research

2. Controllare la connessione

Mandalo in una sessione di agenti freschi. Aspettatevi chiamate get_pricing e get_balance di successo, un prezzo disponibile per google_search e il vostro saldo di credito disponibile. Un saldo zero significa che hai bisogno di crediti per la ricerca; non significa che l'autenticazione sia fallita.

Controllo della connessione
Utilizzare la connessione flashdata esistente MCP.
Chiama get_pricing con {"source":"google_search","request_count":1}.
Chiama get_balance con {}.
Se entrambe le chiamate sono succedute, se la fonte ha un prezzo disponibile,
e il saldo di credito disponibile. Un saldo zero non è un guasto di autenticazione.
Non eseguire una ricerca o scaricare, creare una prova, o modificare le credenziali.

3. Chiedi il tuo primo compito

Incolla questo nel tuo agente collegato. I controlli di bilancia e prezzi sono gratuiti; la ricerca utilizza crediti di conto.

Primo prompt delle attività
Utilizzare FlashData per controllare il mio saldo e il prezzo di una ricerca Google. Se ci sono abbastanza crediti, chiamare google_search una volta con query "battery recycling research", num 5 e la modalità "realtime". Titoli di ritorno, fonte URLs, brevi estratti e crediti reali utilizzati. Smettetela dopo questo compito.

Verifica il risultato

Il tuo agente dovrebbe restituire i link e gli estratti delle fonti, oltre ai crediti effettivi utilizzati. Il risultato di ricerca sottostante ha status: done e results[].organic. Un risultato vuoto è valido; l'agente deve segnalarlo. L'esempio qui sotto è illustrativo.

Esempio di risposta
Completato una ricerca Google.
1. Ricerca per il riciclaggio di batterie — https://example.org/recycling
   Un esempio di ricerca estratto.
Crediti utilizzati: 0.02

Strumenti disponibili

Le chiamate API-chiave usano le autorizzazioni concesse a quella chiave. Scopri gli strumenti e gli schemi di input del server per il catalogo completo.

CompitiStrumentoAccesso
Ricerca Googlegoogle_searchmcp:research / API key
Trova video YouTubeyoutube_searchmcp:research / API key
Leggi i metadati videoyoutube_metadatamcp:research / API key
Recuperare le didascalie esistentiyoutube_transcriptmcp:research / API key
Scarica video o audioyoutube_downloadProprietario API chiave + archiviazione di destinazione
Controllare il conto e i prezziget_balance, get_pricing, get_limits, get_usageLeggi di account gratuito

Informazioni su OAuth, autorizzazioni e prove

OAuth collega il tuo account proprietario verificato e lascia il negozio host e rinfresca i gettoni. La sovvenzione mcp:research copre le quattro fonti di ricerca sopra. Le connessioni API-chiave utilizzano un'intestazione X-API-Key protetta e possono includere altre fonti autorizzate.

Per provare FlashData prima di creare un account, utilizzare il flusso di prova CLI. MCP OAuth collega un account proprietario; non registra o reclama una prova. Un profilo CLI non viene condiviso automaticamente con il tuo host MCP.

Risoluzione dei problemi

ProblematicheProva questo
Strumenti FlashDataTermina il consenso, ricollega e avvia una sessione nuova. Controlla il trasporto URL e Streamable HTTP.
invalid_client / callback errorPer Codex o OpenClaw, utilizzare la sua configurazione client esatta e un browser che può raggiungere il callback locale. Per un altro host, utilizzare la sua configurazione API-chiave o stdio supportata sopra.
401Ricollegare l'accesso OAuth scaduto o revocato, oppure controllare la chiave API fornita all'host. Ripeti il controllo gratuito.
403Controllare la fonte richiesta e le autorizzazioni chiave. YouTube Download richiede un tasto API proprietario con youtube_download e lo storage di destinazione; mcp:research non lo include.
402Controllare Billing e il prezzo attuale. Ricollegare una valida credenziali non aggiunge crediti.
429Seguire Retry-After. Mantenere qualsiasi lavoro esistente o risultato ID prima di decidere se riprova l'attività.
Risposta tempestiva o incompletaTenere la richiesta ID e controllare History. Leggere le prosecuzioni di grandi risultati con get_result invece di ripetere la ricerca.

Go ulteriore