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.
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.
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();
}
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.