Перейти к содержимому
RU
Ключ API

Рабочие процессы / JavaScript

Подключите клиент Node.js MCP к Google Search и YouTube

Подключайтесь к FlashData через потоковые инструменты HTTP, discover MCP и отправляйте явный запрос Google Search от Node.js с помощью официального SDK.

FlashData · Обновлено

Клиент, подключенный через общий интерфейс к инструментам поиска и видео

MCP позволяет клиенту использовать инструменты discover и вызывать их через общий протокол. FlashData предоставляет инструменты данных Google Search и YouTube с помощью удаленной потоковой конечной точки HTTP. Это руководство соединяет клиент Node.js, перечисляет доступные определения инструментов и запускает поиск только тогда, когда вы явно включите его.

Это руководство по интеграции протоколов. Если вы хотите, чтобы обычные функции Python регистрировались с помощью фреймворка агента, используйте Добавьте инструменты поиска Google и YouTube к агенту ИИ.

Установите SDK и сохраните ключ API на сервере.

Используйте Node.js 22 или более поздней версии. В примере используется официальная версия MCP SDK, уже проверенная в документации FlashData. Храните ключ API в серверной среде; не встраивайте его в пакет браузера, публичное хранилище или конечную точку 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'

Конечная точка - это https://data.flashdata.dev/mcp. Аутентификация использует X-API-Key Заголовок. Вам не нужно запускать локальный сервер FlashData. Это соединение использует потоковый HTTP, а не команду stdio.

Подключите, проверьте инструменты и опционально запустите один поиск

Сохранить этот файл как mcp-search.mjs. По умолчанию он вызывает listTools() и печатает доступные имена инструментов и схему ввода Google Search. Инструменты обнаружения не выполняют платный запрос данных.

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 плоские

REST и MCP описывают одну и ту же поисковую задачу с различными формами запросов. Запрос REST помещает внутри страны и языковой контроль params. Инструмент MCP получает gl, hl, num и page непосредственно в arguments; Не посылайте отдыхать params Отзывы об инструменте MCP. Неизвестные поля отклоняются.

Для YouTube проверьте схему инструмента перед построением вызова. Инструмент транскрипции принимает 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; Проверьте это поле. Ошибки в инструментах сохраняют полезный статус upstream и идентификаторы запросов. Исправьте недействительные аргументы, разрешения или кредитный баланс, прежде чем пытаться снова.

Тайм-аут или потерянное соединение не доказывает, что запрос не был выполнен. Для query_outcome_unknown, Проверить запрос History перед повторной отправкой. Этот клиент намеренно не имеет автоматической петли повторного использования вокруг платного вызова инструмента. Большие отклики выше по течению ограничены 4 MiB, поэтому начните с небольшого количества результатов.

Запросы используют существующую стоимость кредитов без дополнительной платы MCP. Прочитай. Ссылка на MCP, Обзор MCP и цена перед тем, как выбрать для производственного клиента параллельные или пакетные размеры.