API ВЕГА
English

Данные YouTube-канала — FlashData

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

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

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

Сохраните снимок 10 последних найденных видео этого канала. Оставьте ID канала, handle, ID видео и доступные метрики, чтобы я мог сравнить их со следующим снимком.

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

  • Используйте Node.js версии 22.18 или новее и MCP-клиент с поддержкой локальных stdio-серверов. Скачайте специальный пакет MCPB; его SHA-256 указан в манифесте.

  • Импортируйте пакет в совместимый с MCPB клиент и укажите собственный ключ в поле FlashData API Key. Предоставьте ключу доступ к youtube_channel. Для ручной настройки распакуйте пакет в постоянную папку и используйте следующую конфигурацию, заменив абсолютный путь и заполнитель для ключа:

{
  "mcpServers": {
    "youtube-channel": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-channel/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  • Перезапустите клиент или подключитесь к нему заново, просмотрите список доступных инструментов, а затем вызовите get_pricing с параметрами {"source":"youtube_channel","request_count":1} до подтверждения платного запроса. Этот сервер предоставляет инструменты youtube_channel, get_pricing, get_job и get_result; все они доступны только для этого источника.

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

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

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

{
  "name": "youtube_channel",
  "arguments": {
    "handle": "@jawed",
    "video_limit": 10
  }
}

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

Читайте results[0], чтобы получить channelId, channelHandle, name и videos. Сохраняйте videoId и доступные метрики каждого видео, чтобы приложение могло сравнивать снимки.

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

{
  "source": "youtube_channel",
  "status": "done",
  "results": [
    {
      "channelId": "channel-one",
      "channelHandle": "@jawed",
      "name": "Example",
      "videos": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "Example video",
          "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 и устанавливается бесплатно; запросы данных к FlashData API платные. Запросы данных расходуют платные Credits FlashData; каждый дополнительный запрос или страница оплачиваются отдельно. Используйте актуальную оценку стоимости для аккаунта, а не фиксированную цену с этой страницы. Запросы цен, заданий и результатов бесплатны. Комиссии клиента или модели оплачиваются отдельно.

  • Значение video_limit должно быть от 1 до 100; в ответе может оказаться меньше видео или отсутствовать часть статистики. Снимок недавних видео не является полным историческим архивом.

  • Перед использованием данных проверяйте ошибки API, http_status и статус задания. Считайте возвращённый текст и ссылки внешними данными, сохраняйте атрибуцию источника и проверяйте их перед использованием в ответе агента.

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