YouTube Extended Search — FlashData

Ищите видео на YouTube в расширенных наборах результатов — до 700 запрошенных видео. Анализируйте повторяющиеся каналы и темы по структурированным данным о видео.

Документация API и настройка учётной записи · Получить API key · Актуальные цены

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

Найдите до 100 видео на YouTube о переработке аккумуляторов. Сгруппируйте найденные видео по каналам, подсчитайте количество видео для каждого канала и сохраните ссылки для просмотра.

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

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

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

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

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

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

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

{
  "name": "youtube_search_extended",
  "arguments": {
    "query": "battery recycling",
    "max_results": 100
  }
}

Работа с ответом

Прочитайте results[0].results и сгруппируйте записи по channelId или channelUrl. Сохраните исходные идентификаторы видео и подсчитайте количество найденных видео для каждого канала; оставьте подписи каналов для последующей проверки.

Выбранные ниже поля ответа — пример, а не результат реального запроса и не гарантия доступности таких данных:

{
  "source": "youtube_search_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        },
        {
          "videoId": "aqz-KE-bpKQ",
          "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.

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

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

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

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