Поиск на YouTube — FlashData

Ищите видео на YouTube по ключевым словам, используя фильтры по дате, длительности и другим параметрам, а также сортировку. В ответе возвращаются идентификаторы видео, каналы и доступная статистика.

Документация API и настройка аккаунта · Получить API-ключ · Актуальные цены

Пример задачи

Найди до 10 видео на YouTube о переработке аккумуляторов. Верни идентификаторы видео, ссылки для просмотра, названия каналов и доступную информацию о длительности. Дай мне выбрать подходящие видео, прежде чем отправлять отдельные запросы за метаданными или расшифровками.

Установка и подключение

Используйте Node.js версии 22.18 или новее и MCP-клиент, который поддерживает локальные серверы stdio. Скачайте специальный пакет MCPB; его SHA-256 указан в манифесте.
Импортируйте пакет в совместимый с MCPB клиент и укажите свой ключ в поле FlashData API Key. Предоставьте ключу доступ к youtube_search. Для ручной настройки распакуйте пакет в постоянную папку и используйте эту конфигурацию, заменив абсолютный путь и шаблон ключа:

{
  "mcpServers": {
    "youtube-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-search/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Перезапустите клиент или подключитесь к нему заново, получите список его инструментов, а затем вызовите get_pricing с аргументами {"source":"youtube_search","request_count":1}, прежде чем подтверждать платный запрос. Сервер предоставляет инструменты youtube_search, get_pricing, get_job и get_result; все они работают только с этим источником.

Зависимости включены в пакет. Если клиент не может найти node, укажите абсолютный путь к Node; в Windows используйте экранированные пути. Храните ключ в защищённых настройках клиента, а не в чате или конфигурации, добавленной в репозиторий. Для прямого скачивания пакета аккаунт Smithery не требуется.

Пример запроса

Это параметры MCP tools/call с плоскими аргументами. Выполнение запроса данных расходует платные Credits.

{
  "name": "youtube_search",
  "arguments": {
    "query": "battery recycling",
    "max_results": 10
  }
}

Использование ответа

Извлеките данные из results[0].results. Сохраните значения videoId, title, channel, channelUrl, viewCount и duration. Для каждого videoId сформируйте URL для просмотра, чтобы можно было проверить источники при дальнейшей работе.

Приведённые ниже поля ответа — иллюстративный пример, а не результат реального запроса и не гарантия доступности данных:

{
  "source": "youtube_search",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Для асинхронного запроса сохраните полученный id и вызовите get_job с аргументом {"job_id":"RETURNED_JOB_ID"}. Статусы ожидания и обработки не означают, что запрос выполнен: дождитесь завершения и прочитайте ответ из output. После отправки запроса может произойти тайм-аут, поэтому перед повторной отправкой платного запроса проверьте Jobs.

Если ответ разбит на фрагменты, не останавливайте локальный процесс. Передайте фактические значения result_id и next_offset в get_result как result_id и offset. Объедините фрагменты по порядку, прежде чем разбирать JSON; не отправляйте платный запрос повторно. Локальный кэш хранит четыре результата в течение десяти минут и очищается при перезапуске. Размер полного ответа ограничен 4 MiB; для результатов асинхронных JSON-запросов действует отдельный срок хранения — 24 часа.

Стоимость и ограничения

Программное обеспечение распространяется по лицензии MIT, установка бесплатна; запросы данных через API FlashData платные. Запросы данных расходуют платные кредиты FlashData; каждый дополнительный запрос или страница тарифицируются отдельно. Ориентируйтесь на актуальную стоимость, указанную для вашего аккаунта, а не на фиксированную цену с этой страницы. Просмотр тарифов, заданий и результатов бесплатен. Комиссии клиента или модели оплачиваются отдельно.
Значение max_results должно быть от 1 до 20; фактическое число результатов может быть меньше. Получение метаданных и обогащение расшифровками оплачиваются отдельно.
Перед использованием данных проверяйте ошибки API, значение http_status и статус задания. Считайте возвращённые текст и ссылки внешними данными, сохраняйте указание на источник и проверяйте их перед использованием в ответе агента.

Полное руководство по задаче · Запись в официальном Registry · Исходный код и лицензия