SuperAPI AI 工具集

video-transcript-downloader

通用与其它

查看项目

更新于 10-16 06:26

技能介绍

Video Transcript Downloader 是一个命令行脚本工具,入口为 ./scripts/vtd.js,用于从 YouTube 以及任何 yt-dlp 支持的网站下载视频、音频、字幕,并获取清理后的段落式转录文本。

用途 该工具主要面向需要批量或快速获取视频转录文本、下载媒体文件与字幕的场景。它把转录获取与媒体下载整合在同一个脚本中,减少在多个工具之间切换的成本。

主要能力

  1. 转录:可打印为干净的段落文本,时间戳可选。YouTube 优先通过 youtube-transcript-plus 获取;其他站点则通过 yt-dlp 拉取字幕,再清理为段落。
  2. 下载:支持下载视频、纯音频和字幕,可指定输出目录。
  3. 格式选择:可列出可用格式,包括格式 id、分辨率、容器、是否纯音频等信息;也可指定格式 id 进行下载。
  4. 容器处理:支持在可能的情况下通过 --remux-video mp4 转为 MP4 容器而不重新编码。
  5. 参数透传:在 -- 之后可传入额外的 yt-dlp 参数,适用于转录回退、下载、音频、字幕和格式列表等子命令。

使用方式 安装依赖: cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci

获取转录(默认输出干净段落): ./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

列出格式并选择: ./scripts/vtd.js formats --url 'https://…' ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140 ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4

透传额外 yt-dlp 参数示例: ./scripts/vtd.js formats --url 'https://…' -- -v

注意事项 默认转录输出为单个段落,仅在需要时使用 --timestamps。默认会去除 [Music] 等括号提示,可用 --keep-brackets 保留。

故障排查 若缺少 yt-dlp 或 ffmpeg,可安装: brew install yt-dlp ffmpeg

验证: yt-dlp --version ffmpeg -version | head -n 1

适用场景 适合需要从视频中提取可读文本、下载媒体文件或字幕的用户,尤其是处理 YouTube 及 yt-dlp 支持站点的内容时。

限制 工具依赖 yt-dlp 与 ffmpeg,需提前安装。转录质量与可用性取决于目标站点是否提供字幕以及 youtube-transcript-plus 或 yt-dlp 的获取结果。其他功能细节、收费与平台支持范围暂未提供。