API ВЕГА
English

Расшифровка YouTube — FlashData

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

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

Попробуйте выполнить задачу

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

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

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

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

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

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

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

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

{
  "name": "youtube_transcript",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en",
    "auto": true
  }
}

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

Читайте results[0].segments. Сохраняйте значения start, end и text; связывайте цитаты с видео и временной меткой начала. Поля languageCode и isAutoGenerated указывают, какая дорожка возвращена.

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

{
  "source": "youtube_transcript",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0,
          "end": 3,
          "text": "Example transcript."
        }
      ]
    }
  ],
  "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 платные. Запросы данных расходуют платные Credits FlashData; каждая дополнительная выборка или страница оплачивается отдельно. Ориентируйтесь на актуальную стоимость для своей учётной записи, а не на фиксированную цену, скопированную с этой страницы. Запросы цен, заданий и результатов бесплатны. Комиссии клиента или модели оплачиваются отдельно.

  • auto=true выбирает существующие автоматически созданные субтитры; распознавание речи не выполняется. Если дорожка недоступна, система не переключается на субтитры, загруженные автором, или на другой язык.

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

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