mcpField
V
video-transcript-downloader

video-transcript-downloader

github.com/steipete创意与媒体7.4k1.0k 次安装1 周前更新
代码仓库

关于 video-transcript-downloader

用于获取视频字幕文本并下载视频、音频或字幕的命令行 Skill。支持清理转录文本、设置时间戳和语言，并通过 yt-dlp 查看与选择格式。

主要功能

  1. 01整理为连贯的转录段落
  2. 02可选时间戳与括号提示
  3. 03下载视频、音频和字幕
  4. 04查看并选择格式
  5. 05传入额外的 yt-dlp 参数

适用场景

  1. 01将视频转录整理为可读文本
  2. 02在本地保存视频或音频
  3. 03下载指定语言的字幕

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/steipete/agent-scripts --skill video-transcript-downloader

安装后在 Claude Code 中输入/video-transcript-downloader确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
package-lock.json
package.json
scripts/
html-entities.js
vtd.js
vtd.test.mjs

详细介绍

视频字幕下载器

./scripts/vtd.js 可以：

  • 将字幕打印为简洁的段落（时间戳可选）。
  • 下载视频／音频／字幕。

字幕处理方式：

  • YouTube：尽可能通过 youtube-transcript-plus 获取字幕。
  • 否则：通过 yt-dlp 获取字幕，然后整理成段落。

设置

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

命令行语法：

./scripts/vtd.js --help
./scripts/vtd.js transcript --help

子命令支持查看专门的帮助，无需提供 --url。

字幕（默认：简洁段落）

./scripts/vtd.js transcript --url 'https://…'
./scripts/vtd.js transcript --url 'https://…' --lang en
./scripts/vtd.js transcript --url 'https://…' --timestamps
./scripts/vtd.js transcript --url 'https://…' --keep-brackets

下载视频／音频／字幕

./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

格式（列出并选择）

列出可用格式（格式 ID、分辨率、容器、仅音频等）：

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

下载指定的格式 ID（示例）：

./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

说明

  • 默认将字幕输出为一个段落。仅在需要时使用 --timestamps。
  • 默认会移除 [Music] 等方括号提示；使用 --keep-brackets 可保留。
  • 对于 transcript 的回退处理、download、audio、subs 和 formats，可在 -- 后传入额外的 yt-dlp 参数。
./scripts/vtd.js formats --url 'https://…' -- -v

故障排除（仅在需要时）

  • 缺少 yt-dlp／ffmpeg：
brew install yt-dlp ffmpeg
  • 验证：
yt-dlp --version
ffmpeg -version | head -n 1

评论

支持 Markdown