Ga naar de inhoud
NL
API-sleutel ophalen

Werkstromen / JavaScript

Sluit een Node.js MCP client aan op Google Search en YouTube

Verbind met FlashData via Streamable HTTP, discover MCP tools, en stuur een expliciete Google Search verzoek van Node.js met behulp van de officiële SDK.

FlashData · Bijgewerkt

Een client verbonden via een gedeelde interface naar zoek- en videotools

MCP laat een client discover tools toe en belt ze via een gedeeld protocol. FlashData stelt Google Search en YouTube datatools bloot via een op afstand streamable HTTP eindpunt. Deze tutorial verbindt een Node.js client, geeft een lijst van de beschikbare tooldefinities, en voert een zoekopdracht alleen uit wanneer u het expliciet inschakelt.

Dit is een protocol integratie gids. Als u wilt dat gewone Python functies zich registreren met een agent framework, gebruik Google en YouTube zoekgereedschappen toevoegen aan een AI-agent.

Installeer de SDK en houd de API sleutel op de server

Gebruik Node.js 22 of later. Het voorbeeld gebruikt de officiële MCP SDK versie die al is geverifieerd in de FlashData documentatie. Houd de API-sleutel in een serveromgeving; sluit deze niet in in een browserbundel, openbare repository of MCP-eindpunt 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'

Het eindpunt is https://data.flashdata.dev/mcp. Authenticatie maakt gebruik van de X-API-Key kop. U hoeft geen lokale FlashData-server te starten. Deze verbinding maakt gebruik van streamable HTTP, geen stdio commando.

Verbinden, inspecteren en eventueel één zoekopdracht uitvoeren

Dit bestand opslaan als mcp-search.mjs. Standaard roept het aan listTools() en drukt de beschikbare gereedschapsnamen en het Google Search invoerschema af. Ontdek tools voert geen betaalde data query uit.

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

MCP argumenten zijn plat

REST en MCP beschrijven dezelfde zoekopdracht met verschillende aanvraagvormen. Een REST query plaatst land- en taalcontrole binnen params. Een MCP tool ontvangt gl, hl, num en page rechtstreeks in arguments; stuur geen REST params bezwaar tegen het MCP gereedschap. Onbekende velden worden afgewezen.

Voor YouTube, inspecteer de tool schema voordat u een call construeren. Een transcript tool neemt video_id, language en auto; auto selecteert de bestaande automatische of uploader-geleverd track. Het genereert geen bijschriften voor een video die ze mist.

Asynchrone taken en grote resultaten verwerken

Gebruik mode: "async" wanneer u een sollicitatiebon wilt in plaats van een real-time resultaat. Houd de teruggekeerde job ID en geef het door als job_id tot get_job. Voltooide jobs omvatten de oorspronkelijke respons in output; de resultaten worden bewaard voor 24 uren na voltooiing. Het lezen van een taak stuurt de zoekopdracht niet opnieuw in.

Grote resultaten kunnen komen als een JSON tekst brok met result_id en next_offset. Oproep get_result met dezelfde sleutel en ga verder met het gebruik van de geretourneerde offset tot next_offset is null. Verzamel stukken in volgorde voordat ze ontleden. De limiet wordt gemeten in UTF-16 code eenheden, geen rijen of bytes. Het resultaat cache duurt 10 minuten, heeft maximaal vier grote resultaten per toets, en kan resultaten eerder uitzetten.

Om video of audio naar uw opslag te leveren, bel youtube_download met een storage bestemming en een API sleutel die youtube_download verleent. Bewaar de teruggekeerde job ID en poll get_job. Voor bestandsgebaseerde Bulk verwerking, gebruik de API voor Bulk-verwerking.

Mislukkingen behandelen volgens wat er gebeurd is

Een succesvolle HTTP uitwisseling kan nog steeds een gereedschapsresultaat bevatten met isError: true; Controleer dat veld. Gereedschapsfouten behouden nuttige upstream status en verzoeken om identificatie. Fix ongeldige argumenten, machtigingen of Credit balance voordat u het opnieuw probeert.

Een timeout of verloren verbinding bewijst niet dat een query niet is uitgevoerd. Voor query_outcome_unknown, inspecteer Verzoek History voordat opnieuw wordt ingediend. Deze client heeft bewust geen automatische retry loop rond een betaalde tool call. Grote upstream responsen zijn beperkt tot 4 MiB, dus begin met een klein aantal resultaten.

Queries gebruiken uw bestaande Credits-prijsstelling, zonder extra MCP-tarief. Lees het MCP-referentie, MCP overzicht en prijsstelling voordat u kiest voor concurrency of batch maten voor een productiecliënt.