MCP дозволяє клієнтові інструменти discover і викликати їх через загальний протокол. FlashData виводить Google Search і YouTube інструменти даних через дистанційну потокову точку HTTP. Цей підручник з'єднує клієнт Node.js, списує доступні визначення інструментів, і працює пошук тільки тоді, коли ви явно ввімкнете його.
Це інструкція із інтеграції протоколу. Якщо ви хочете Python функції для реєстрації в рамках агента, використання Додати інструменти пошуку Google та YouTube до агента AI.
Встановіть SDK і зберігайте ключ API на сервері
Використовуйте Node.js 22 або пізніше. Приклад використовує офіційну версію MCP SDK вже перевірену в документації FlashData. Зберігати API ключ в серверному середовищі; не вбудовуйте його в поштовій скриньці браузера, державну репозиторію або 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'
Кінцева точка https://data.flashdata.dev/mcp. Ауттентифікація використовує X-API-Key головки. Вам не потрібно запустити локальний сервер FlashData. Цей зв'язок використовує потоковий HTTP, не команду stdio.
Підключіть, перевірте інструменти та необов'язково запустіть один пошук
Заощаджуйте цей файл mcp-search.mjs. За замовчуванням це виклики listTools() і друкує доступні імена інструментів і вхідний schema Google Search. Виявляти інструменти не виконують запит на платні дані.
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
MCP аргументи плоскі
REST і MCP описують те ж саме завдання пошуку з різними формами запиту. Ведуться роботи з працевлаштуванням та інформаційним управлінням params. Інструмент MCP отримує gl, hl, num і page прямо в arguments; не надсилайте REST params об'єкт до інструмента MCP. Невідомі поля відхилені.
Для YouTube, перевіряйте щім інструментом перед створенням виклику. Інструмент для транк-script video_id, language і auto; auto вибирає існуючу автоматичну або завантажувальну трасу. Не генерує підписи для відео, що не вистачає їх.
Ручка асинхронні роботи і великі результати
Зареєструватися mode: "async" коли ви хочете отримати квитанцію в режимі реального часу. Зберігайте повернуту роботу ID і пропустіть його як job_id до get_job. Виконані роботи включають оригінальну відповідь в output; результати зберігають на 24 години після завершення. Прочитати роботу не подає запиту знову.
Більші результати можуть прибути як JSON текстовий роз'єм з result_id і next_offset. Дзвоните до get_result з тим же ключем і продовженням за допомогою повернутого офсету до тих пір, поки next_offset ЦЕНА ЗА ЧАС: null. Конкатенітні шматочки для того, щоб до припаття. Обмеження вимірюється в UTF-16 кодових юнітів, не рядків або байтів. В результаті кеш триває хвилин 10, що займає найчотирьох великих результатів за ключ, і може швидше зважити результати.
Для доставки відео або аудіо на Ваше сховище, виклик youtube_download з storage API ключ, який надає youtube_download. Заощаджуйте роботу ID та опитування get_job. Для обробки файлів Bulk використовуйте API обробки Bulk.
Збої протоки, що сталося
Успішний обмін HTTP все ще може містити результат інструменту з isError: true; перевірити це поле. Помилки інструментів зберігають корисний статус та ідентифікатор запитів. Виправлення недійсних аргументів, дозволів або кредитного балансу перед спробою знову.
Часовий або втрачений з'єднання не доводить, що запит не був виконаний. Для query_outcome_unknown, огляд Запит History перед переадресацією. Цей клієнт навмисно не має автоматичної петля петля петля навколо платного виклику інструменту. Великі відповіді на потік обмежені 4 MiB, щоб почати з невеликого підрахунку результату.
Запитання щодо використання вашого існуючого кредитного ціноутворення, без додаткового MCP доля. Читати далі MCP посилання, Огляд MCP і Твитнуть перед тим, як вибрати опуклість або розміри партії для клієнта, що виробляє.