Метаданные YouTube — FlashData

Читайте сведения о видео на YouTube, описания, статистику и доступные главы. Проверяйте форматы или создавайте навигацию по главам с временными метками.

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

Задание для проверки

Изучите это видео и составьте краткую навигацию по главам с названием, описанием и доступным временем начала каждой главы. Если главы не указаны, отметьте это, не придумывая временную шкалу.

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

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

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

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

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

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

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

{
  "name": "youtube_metadata",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "include_formats": false,
    "include_chapters": true
  }
}

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

Изучите results[0], в том числе название, описание и главы, если они есть. Используйте start_time и end_time глав вместе с URL просмотра видео, чтобы составить краткую навигацию.

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

{
  "source": "youtube_metadata",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "title": "Example video",
      "channel": "Example",
      "channelId": "channel-one",
      "channelUrl": "https://www.youtube.com/@Example",
      "viewCount": 100,
      "duration": 90,
      "chapters": [
        {
          "title": "Introduction",
          "start_time": 0,
          "end_time": 30
        }
      ],
      "description": "Example description"
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

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

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

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

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

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