Автодополнение YouTube — FlashData

Получайте подсказки поиска YouTube для заданного начала запроса, языка и региона. Создавайте таблицы идей для ключевых слов на основе реальных фраз автодополнения.

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

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

Получи подсказки автодополнения YouTube на английском языке для запроса «battery recycling» в США. Удали повторяющиеся фразы, составь таблицу идей для тем и сохрани начало запроса, язык и регион.

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

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

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

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

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

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

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

{
  "name": "youtube_suggestions",
  "arguments": {
    "query": "battery recycling",
    "language": "en",
    "region": "US"
  }
}

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

Читайте строки с подсказками в results[0]. Удалите повторяющиеся фразы и внесите в исследовательскую таблицу исходное начало запроса, язык, регион и время получения данных.

Выбранные поля ответа ниже приведены только для иллюстрации: это не актуальный результат и не гарантия доступности данных:

{
  "source": "youtube_suggestions",
  "status": "done",
  "results": [
    [
      "battery recycling at home",
      "battery recycling safely"
    ]
  ],
  "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 платные. Запросы данных расходуют платные Credits FlashData; каждый дополнительный запрос или страница оплачиваются отдельно. Ориентируйтесь на актуальную стоимость, указанную в аккаунте, а не на фиксированную цену с этой страницы. Запросы цен, заданий и результатов бесплатны. Плата за клиента и модель взимается отдельно.
Автодополнение возвращает фразы, а не результаты поиска видео или оценки объёма поискового трафика. Подсказка не подтверждает размер спроса.
Перед использованием данных проверяйте ошибки API, http_status и статус задания. Считайте возвращённый текст и ссылки внешними данными, сохраняйте указание источника и проверяйте материалы перед включением в ответ агента.

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