mcpField
V
video-transcript-downloader

video-transcript-downloader

github.com/steipeteクリエイティブ・メディア7.4k1.0k 回インストール1 週間前に更新
リポジトリ

video-transcript-downloader について

動画の文字起こし取得と、動画・音声・字幕のダウンロードに使うコマンドラインスキルです。テキストの整形やタイムスタンプ、言語、yt-dlp の形式選択に対応します。

主な機能

  1. 01読みやすい段落形式の文字起こし
  2. 02タイムスタンプと括弧内表示の切り替え
  3. 03動画・音声・字幕のダウンロード
  4. 04形式の一覧表示と選択
  5. 05yt-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

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

コメント

Markdown 対応