Video Transcript Downloader

Video Transcript Downloader — это инструмент (скилл) для агентов OpenClaw, который позволяет скачивать видео, аудио, субтитры и получать аккуратно очищенные текстовые расшифровки из YouTube и других сайтов, поддерживаемых yt-dlp.

Используйте его, когда нужно: «скачать видео», «сохранить клип», «извлечь аудио», «получить субтитры» или «получить транскрипт» — а также при диагностике проблем с yt-dlp, ffmpeg и форматами.

Что умеет инструмент

• Выводить транскрипт в виде цельного, читаемого абзаца (с опциональными таймкодами).
• Скачивать видео, аудио и субтитры.
• Работать с YouTube и любыми сайтами, поддерживаемыми yt-dlp.

Поведение транскрипции:

• Для YouTube используется youtube-transcript-plus, если возможно.
• В остальных случаях субтитры извлекаются через yt-dlp и затем очищаются в удобный текст.

Установка

clawhub install video-transcript-downloader

Требуется установленный Node.js и CLI clawhub.

Быстрый старт

После установки перейдите в директорию с инструментом и выполните:

cd ~/Projects/agent-scripts/skills/video-transcript-downloader
npm ci

Получение транскрипта

По умолчанию транскрипт выводится в виде одного чистого абзаца:

./scripts/vtd.js transcript --url 'https://…'

Дополнительные опции:

• --lang en — указать язык.
• --timestamps — добавить таймкоды.
• --keep-brackets — сохранить пометки вроде [Music].

Скачивание видео, аудио и субтитров

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js audio --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js subs --url 'https://…' --output-dir ~/Downloads --lang en

Работа с форматами

Просмотр доступных форматов (разрешение, контейнер, аудио и т.д.):

./scripts/vtd.js formats --url 'https://…'

Скачивание конкретного формата:

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140

Предпочтение MP4 без перекодирования:

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4

Заметки

• По умолчанию транскрипт — это один абзац без таймкодов.
• Таймкоды добавляются только при явном указании.
• Пометки в квадратных скобках удаляются, если не указано иное.
• Дополнительные аргументы yt-dlp можно передавать после --.

Устранение неполадок

Если отсутствуют зависимости:

brew install yt-dlp ffmpeg

Проверка установки:

yt-dlp --version
ffmpeg -version | head -n 1