Communitygithub.com

steipete/video-transcript-downloader

使用 yt-dlp 下載影片、音訊、字幕、逐字稿、剪輯與播放清單。

video-transcript-downloader 是什麼?

Video Transcript Downloader 是一款 AI 代理技能,專為處理影片內容的下載與文字化而設計,主要支援 YouTube 及多數影片平台。它提供了三個核心功能:取得逐字稿(可選擇是否保留時間戳記)、下載影片/音訊/字幕檔案,以及列舉並選擇可用格式。該技能內部使用 `youtube-transcript-plus` 直接擷取 YouTube 逐字稿,若無法取得則自動以 `yt-dlp` 提取字幕並清理為乾淨段落;下載功能則完全基於 `yt-dlp`,並支援額外參數傳遞(例如指定格式 ID、重新封裝為 MP4)。支援的平台包括 Claude Code、Cursor、Codex 等任何可執行 Node.js 腳本的 AI 代理環境。使用者只需提供影片 URL,即可透過簡單的 CLI 指令快速完成作業,例如 `./scripts/vtd.js transcript --url 'https://…'` 即可取得逐字稿。此技能特別適合需要從線上教學、會議記錄或 Podcast 中提取文字或媒體檔案的開發者與研究者。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Video Transcript Downloader

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

相關技能