Communitygithub.com

steipete/video-transcript-downloader

yt-dlpを利用した動画・音声・字幕・トランスクリプト・クリップ・プレイリストのダウンロードツール

video-transcript-downloader とは?

このスキルは、YouTubeなどの動画プラットフォームから高品質なトランスクリプト(文字起こし)や字幕、動画・音声ファイルを簡単に取得できる強力なCLIツールです。主に `yt-dlp` と `youtube-transcript-plus` をバックエンドとして利用し、トランスクリプトはデフォルトでタイムスタンプなしのクリーンな段落形式で出力されます。YouTube動画の場合は専用ライブラリで高速取得、それ以外のプラットフォームではyt-dlp経由で字幕を取得し整形します。さらに、特定のフォーマットIDを指定したダウンロードや、音声のみ・字幕のみの抽出、MP4へのリマックス、 `--keep-brackets` オプションによるブラケット記号の保持など、細かな制御が可能です。このスキルは、CLIエージェント(Claude Code, Cursor, Codexなど)向けに設計されており、自然言語の指示からスクリプトを実行することで、開発者やパワーユーザーの動画関連ワークフローを大幅に効率化します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 を使用してください。
  • 追加の yt-dlp 引数は -- の後に渡してください(transcript フォールバック、download、audio、subs、formats で使用可能)。
./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.

関連スキル