Salta al contenuto
IT
Ottieni la chiave API

Flussi di lavoro / JavaScript

Collegare un client Node.js MCP alla ricerca Google e YouTube

Collegamento a FlashData sopra Streaming HTTP, discover MCP strumenti, e inviare un esplicito Google Richiesta di ricerca da Node.js utilizzando il funzionario SDK.

FlashData · Aggiornato

Un client collegato tramite un'interfaccia condivisa per ricercare e strumenti video

MCP consente a un client di utilizzare gli strumenti discover e di chiamarli tramite un protocollo condiviso. FlashData espone gli strumenti di dati Google Search e YouTube attraverso un endpoint remoto Streamable HTTP. Questo tutorial collega un client Node.js, elenca le definizioni degli strumenti disponibili, ed esegue una ricerca solo quando lo si abilita esplicitamente.

Questa è una guida di integrazione del protocollo. Se si desidera che le normali funzioni Python registrino con un quadro agente, utilizzare Aggiungi strumenti di ricerca Google e YouTube a un agente AI.

Installare lo SDK e mantenere il tasto API sul server

Utilizzare Node.js 22 o versioni successive. L'esempio utilizza la versione ufficiale MCP SDK già verificata nella documentazione FlashData. Mantenere il tasto API in un ambiente server; non incorporarlo in un pacchetto di browser, repository pubblico o MCP endpoint URL.

bash
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'

Il punto finale è https://data.flashdata.dev/mcp. L'autenticazione utilizza X-API-Key Intestazione. Non è necessario avviare un server FlashData locale. Questa connessione utilizza Streamable HTTP, non un comando stdio.

Collegare, ispezionare gli strumenti e eseguire facoltativamente una ricerca

Salvare questo file come mcp-search.mjs. Per impostazione predefinita chiama listTools() e stampa i nomi degli strumenti disponibili e lo schema di input di ricerca Google. L'individuazione degli strumenti non esegue una query dei dati pagati.

javascript
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: "search-example", version: "1.0.0" });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL("https://data.flashdata.dev/mcp"),
    { requestInit: { headers: { "X-API-Key": key } } },
  ));
  const { tools } = await client.listTools();
  console.log("Available tools:", tools.map(tool => tool.name));
  const search = tools.find(tool => tool.name === "google_search");
  if (!search) throw new Error("google_search is not available to this client.");
  console.log("Search input schema:", JSON.stringify(search.inputSchema, null, 2));
  if (process.env.RUN_SEARCH === "1") {
    const result = await client.callTool({
      name: "google_search",
      arguments: { query: process.env.SEARCH_QUERY ?? "MCP protocol",
        gl: "us", hl: "en", num: 3, page: 1, mode: "realtime" },
    });
    if (result.isError) {
      console.error(JSON.stringify(result, null, 2));
      process.exitCode = 1;
    } else {
      console.log(JSON.stringify(result, null, 2));
    }
  } else {
    console.log("Discovery complete. Set RUN_SEARCH=1 to submit a billable query.");
  }
} finally {
  await client.close();
}
bash
node mcp-search.mjs
# Run only when you are ready to submit a search using account Credits:
RUN_SEARCH=1 SEARCH_QUERY='MCP protocol' node mcp-search.mjs

Gli argomenti MCP sono piatti

REST e MCP descrivono lo stesso compito di ricerca con diverse forme di richiesta. Una query REST pone i controlli del paese e della lingua all'interno params. Riceve uno strumento MCP gl, hl, num e page direttamente in arguments; non inviare un REST params oggetti allo strumento MCP. I campi sconosciuti sono respinti.

Per YouTube, ispezionare lo schema dello strumento prima di costruire una chiamata. Uno strumento di trascrizione richiede video_id, language e auto; auto seleziona la traccia automatica o di uploader già esistente. Non genera didascalie per un video che li manca.

Maneggiare lavori asincroni e risultati grandi

Uso mode: "async" quando si desidera una ricevuta di lavoro invece di un risultato in tempo reale. Mantenere il lavoro restituito ID e passarlo come job_id a get_job. I lavori completi includono la risposta originale in output; i risultati sono conservati per 24 ore dopo il completamento. Leggere un lavoro non invia di nuovo la query.

Grandi risultati possono arrivare come un testo JSON con result_id e next_offset. Chiamata get_result con la stessa chiave e continuare a utilizzare l'offset restituito fino a next_offset è null. Concatena i pezzi in ordine prima di parsing. Il limite è misurato in unità di codice UTF-16, non righe o byte. La cache dei risultati dura 10 minuti, detiene al massimo quattro grandi risultati per chiave, e può espellere i risultati prima.

Per fornire video o audio al tuo storage, chiama youtube_download con un storage destinazione e chiave API che garantisce youtube_download. Salvare il lavoro restituito ID e sondaggio get_job. Per l'elaborazione Bulk basata su file, utilizzare il API di elaborazione Bulk.

Trattare fallimenti secondo ciò che è successo

Uno scambio di successo HTTP può ancora contenere un risultato di strumento isError: true; controlla quel campo. Gli errori degli strumenti mantengono lo stato utile a monte e gli identificatori di richiesta. Fissare argomenti, autorizzazioni o saldo di credito non validi prima di provare di nuovo.

Una connessione timeout o persa non dimostra che una query non è stata eseguita. Per query_outcome_unknown, ispeziona richiesta History prima di risottomettere. Questo cliente deliberatamente non ha un loop di riprovazione automatico intorno a una chiamata a pagamento. Le grandi risposte a monte sono limitate a 4 MiB, quindi inizia con un piccolo numero di risultati.

Le query utilizzano il prezzo dei crediti esistenti, senza costi aggiuntivi di MCP. Leggi il testo Riferimento MCP, Panoramica MCP e prezzi prima di scegliere le dimensioni concurrency o batch per un cliente di produzione.