Aller au contenu
FR
Obtenir une clé API

Flux de travail / JavaScript

Connecter un client MCP Node.js à Google Search et YouTube

Connectez-vous à FlashData via Streamable HTTP, découvrez les outils MCP et lancez explicitement une recherche Google depuis Node.js avec le SDK officiel.

FlashData · Mis à jour le

Un client connecté par une interface partagée aux outils de recherche et de vidéo

MCP permet à un client de découvrir des outils et de les appeler via un protocole commun. FlashData expose des outils Google Search et YouTube via un endpoint distant Streamable HTTP. Ce tutoriel connecte un client Node.js, liste les définitions des outils disponibles et lance une recherche uniquement si vous l’activez explicitement.

Ce guide porte sur l’intégration du protocole. Pour intégrer des fonctions Python à un framework d’agents, consultez Ajouter des outils de recherche Google et YouTube à un agent IA.

Installer le SDK et conserver la clé API sur le serveur

Utilisez Node.js 22 ou une version ultérieure. L’exemple utilise la version du SDK MCP officiel déjà vérifiée dans la documentation FlashData. Conservez la clé API dans l’environnement du serveur ; ne l’intégrez pas au code envoyé au navigateur, à un dépôt public ni à l’URL de l’endpoint MCP.

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

L’endpoint est https://data.flashdata.dev/mcp. L’authentification utilise l’en-tête X-API-Key. Aucun serveur FlashData local n’est nécessaire. La connexion utilise Streamable HTTP, et non une commande stdio.

Se connecter, examiner les outils et lancer une recherche

Enregistrez ce fichier sous le nom mcp-search.mjs. Par défaut, il appelle listTools() et affiche les noms des outils disponibles ainsi que le schéma d’entrée de Google Search. La découverte des outils n’exécute aucune requête de données payante.

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

Les arguments MCP ne sont pas imbriqués

REST et MCP décrivent la même recherche avec des structures de requête différentes. Une requête REST place les paramètres de pays et de langue dans params. Un outil MCP reçoit gl, hl, num et page directement dans arguments ; n’envoyez pas l’objet REST params à l’outil MCP. Les champs inconnus sont rejetés.

Pour YouTube, examinez le schéma de l’outil avant de construire un appel. Un outil de transcription reçoit video_id, language et auto; auto sélectionne la piste existante, générée automatiquement ou fournie par le créateur. Il ne crée pas de sous-titres pour une vidéo qui n’en possède pas.

Gérer les jobs asynchrones et les résultats volumineux

Utilisez mode: "async" pour obtenir un reçu de job plutôt qu’un résultat en temps réel. Conservez l’ID du job renvoyé et transmettez-le comme job_id à get_job. Les jobs terminés incluent la réponse d’origine dans output ; les résultats sont conservés pendant 24 heures après la fin du job. Consulter un job ne soumet pas à nouveau la requête.

Un résultat volumineux peut être renvoyé sous forme de fragment de texte JSON avec result_id et next_offset. Appelez get_result avec la même clé et utilisez chaque décalage renvoyé jusqu’à ce que next_offset soit null. Concaténez les fragments dans l’ordre avant de les analyser. La limite est mesurée en unités de code UTF-16, pas en lignes ni en octets. Le cache conserve les résultats pendant 10 minutes, à raison de quatre résultats volumineux au maximum par clé, et peut les supprimer plus tôt.

Pour livrer une vidéo ou un fichier audio dans votre stockage, appelez youtube_download avec une destination storage et une clé API autorisant youtube_download. Enregistrez l’identifiant de tâche renvoyé, puis vérifiez son état avec get_job. Pour traiter un fichier d’identifiants avec Bulk, utilisez l’API de traitement Bulk.

Traiter les erreurs selon leur cause

Même si l’échange HTTP réussit, le résultat de l’outil peut contenir isError: true ; vérifiez ce champ. Les erreurs d’outil conservent les informations utiles de statut amont et les identifiants de requête. Corrigez les arguments, les permissions ou le solde de crédits avant de réessayer.

Un délai dépassé ou une connexion interrompue ne prouve pas que la requête n’a pas été exécutée. Pour query_outcome_unknown, consultez Request History avant de soumettre à nouveau la requête. Ce client ne relance pas automatiquement les appels d’outils payants. Les réponses amont sont limitées à 4 MiB ; commencez donc avec peu de résultats.

Les requêtes utilisent votre tarification habituelle en crédits, sans supplément MCP. Consultez la référence MCP, la présentation de MCP et les tarifs avant de choisir le nombre d’appels simultanés ou la taille des lots pour un client en production.