Communitygithub.com

视频字幕下载器

使用 yt-dlp 下载视频、音频、字幕、转录文本、片段和播放列表。

视频字幕下载器 是什么?

Video Transcript Downloader 是一个 AI 代理技能,专为从 YouTube 等平台提取和下载视频内容及字幕而设计。其主要功能包括:以整洁段落形式打印转录文本(可选时间戳)、下载视频/音频/字幕、列出与选择可用格式。该技能支持多种代理平台(如 Claude Code、Cursor、Codex),通过本地安装的 npm 包和 `yt-dlp`、`ffmpeg` 工具运行。它优先使用 `youtube-transcript-plus` 获取 YouTube 转录,否则回退到 `yt-dlp` 提取字幕并清理为段落。用户可以通过简单 CLI 命令 `transcript`、`download`、`audio`、`subs` 和 `formats` 进行操作,并支持传递额外 `yt-dlp` 参数以实现高级下载控制。对于开发者和 AI 代理用户而言,本技能简化了视频内容处理流程,无需手动编写复杂命令即可快速获取所需媒体的文字或文件。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/video-transcript-downloader

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

视频字幕下载器 是做什么的?

./scripts/vtd.js 可以:

  • 以整洁段落形式打印转录文本(可选时间戳)。
  • 下载视频/音频/字幕。

转录行为:

  • YouTube:尽可能通过 youtube-transcript-plus 获取。
  • 否则:通过 yt-dlp 拉取字幕,然后清理为段落。

设置

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

CLI 语法:

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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相关技能