Przejdź do treści
PL
Uzyskaj klucz API

Przepływy pracy / JavaScript

Podłącz klienta Node.js MCP do Google Search i YouTube

Połącz się z FlashData przez Streamable HTTP, discover MCP i wyślij wyraźny wniosek Google Search od Node.js przy użyciu oficjalnego SDK.

FlashData · Aktualizacja

Klient podłączony za pośrednictwem wspólnego interfejsu do wyszukiwania i narzędzi wideo

MCP pozwala klientowi na korzystanie z narzędzi discover i wywoływanie ich poprzez wspólny protokół. FlashData ujawnia narzędzia danych Google Search i YouTube za pomocą zdalnego punktu końcowego HTTP. Ten poradnik łączy klienta Node.js, wymienia dostępne definicje narzędzi i uruchamia wyszukiwanie tylko wtedy, gdy wyraźnie je włączysz.

To jest przewodnik integracji protokołu. Jeśli chcesz, aby zwykłe funkcje Python rejestrowały się w ramce agenta, użyj Dodaj narzędzia wyszukiwania Google i YouTube do agenta AI.

Zainstaluj SDK i trzymaj klawisz API na serwerze

Należy stosować Node.js 22 lub później. Przykład wykorzystuje oficjalną wersję MCP SDK zweryfikowaną już w dokumentacji FlashData. Klucz API należy przechowywać w środowisku serwera; nie umieszczać go w pakiecie przeglądarek, repozytorium publiczne lub w punkcie końcowym MCP 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'

Punkt końcowy to https://data.flashdata.dev/mcp. Uwierzytelnianie wykorzystuje X-API-Key nagłówek. Nie trzeba uruchamiać lokalnego serwera FlashData. To połączenie wykorzystuje Streamable HTTP, a nie polecenie stdio.

Podłącz, sprawdź narzędzia i opcjonalnie uruchom jedno wyszukiwanie

Zapisz ten plik jako mcp-search.mjs. Domyślnie wywołania listTools() i drukuje dostępne nazwy narzędzi i schemat wejścia Google Search. Odkrywanie narzędzi nie wykonuje zapytania o dane płatne.

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

Argumenty MCP są płaskie

REST i MCP opisują to samo zadanie wyszukiwania o różnych kształtach żądania. Zapytanie REST umieszcza kontroli kraju i języka wewnątrz params. Narzędzie MCP otrzymuje gl, hl, num oraz page bezpośrednio w arguments; nie wysyłaj REST params obiekt do narzędzia MCP. Nieznane pola są odrzucane.

W przypadku YouTube przed wykonaniem połączenia należy sprawdzić schemat narzędzia. Narzędzie transkrypcyjne wymaga video_id, language oraz auto; auto wybiera istniejący tor automatyczny lub uploaderowy. To nie generuje podpisy do filmu, który ich nie ma.

Zajmuj się asynchronicznymi zadaniami i dużymi wynikami

Stosowanie mode: "async" gdy chcesz pokwitowania pracy zamiast realtime wynik. Zachowaj zwróconą pracę ID i podaj jako job_id do get_job. Ukończone zadania obejmują pierwotną odpowiedź w output; wyniki są zachowane dla 24 godziny po zakończeniu. Czytanie zadania nie powoduje ponownego przesłania zapytania.

Duże wyniki mogą pojawić się jako JSON kawałek tekstu z result_id oraz next_offset. Zawołaj get_result z tym samym kluczem i nadal używać zwróconego przesunięcia aż next_offset en null. Zbierz kawałki w kolejności przed parsowaniem. Limit jest mierzony w jednostkach kodowych UTF- 16, nie wierszach ani bajtach. Wynik pamięci podręcznej trwa 10 minut, posiada co najmniej cztery duże wyniki na klucz, i może eksmitować wyniki szybciej.

Aby dostarczyć wideo lub audio do magazynu, zadzwoń youtube_download o storage cel i klucz API, który przyznaje youtube_download. Zapisz zwróconą pracę ID i ankietę get_job. Do przetwarzania na bazie plików Bulk należy użyć API przetwarzania Bulk.

Leczenie niepowodzeń w zależności od tego, co się stało

Udana wymiana HTTP może nadal zawierać wynik narzędzia z isError: true; Sprawdź to pole. Błędy narzędzia zachowują przydatny status i identyfikatory żądań. Przed ponownym wypróbowaniem naprawić nieprawidłowe argumenty, uprawnienia lub saldo kredytowe.

Czas lub utracone połączenie nie dowodzi, że zapytanie nie zostało wykonane. Dla query_outcome_unknown, Inspect Request History przed wznowieniem. Ten klient celowo nie ma automatycznej pętli retry wokół płatnego połączenia narzędzia. Duże odpowiedzi na początku łańcucha dostaw są ograniczone do 4 MiB, więc zacznij od małej liczby wyników.

Zapytania korzystają z istniejących cen kredytów, bez dodatkowych opłat MCP. Przeczytaj MCP odniesienia, Przegląd MCP oraz Ceny przed wybraniem dla klienta produkującego odpowiedniej wielkości lub partii.