YouTube Transcript Downloader
YouTube動画から字幕を抽出し処理するスキルです。
優先順位
1. yt-dlpのインストール確認
2. 利用可能な字幕リストの確認
3. 手動字幕を優先して試行
4. 自動生成字幕へのフォールバック
5. 最終手段: Whisper変換
要件
# macOS
brew install yt-dlp
# Linux
sudo apt install yt-dlp
# 共通
pip install yt-dlp
ワークフロー
Step 1: 字幕リストの確認
yt-dlp --list-subs "VIDEO_URL"
Step 2: 手動字幕のダウンロード(推奨)
# 日本語字幕
yt-dlp --write-sub --sub-lang ja --skip-download "VIDEO_URL"
# 英語字幕
yt-dlp --write-sub --sub-lang en --skip-download "VIDEO_URL"
Step 3: 自動生成字幕(フォールバック)
yt-dlp --write-auto-sub --sub-lang ja --skip-download "VIDEO_URL"
Step 4: VTT→テキスト変換
# VTTファイルからタイムスタンプを除去
sed '/^[0-9]/d; /^$/d; /-->/d' subtitle.ja.vtt > transcript.txt
出力処理
重複除去
自動生成字幕はプログレッシブキャプションにより重複が多い:
# 重複行を除去
seen = set()
unique_lines = []
for line in lines:
if line not in seen:
seen.add(line)
unique_lines.append(line)
要約生成
抽出された字幕から:
- 核心内容の要約
- タイムスタンプ別のチャプター生成
- 主要キーワードの抽出
使用例
例1: 講義動画の要約
ユーザー: このYouTube講義を要約して - https://youtube.com/watch?v=xxx
Claude:
1. yt-dlpで字幕をダウンロード
2. VTT→テキスト変換
3. 核心内容の要約を生成
4. タイムスタンプ別の目次を提供
例2: 多言語字幕の抽出
ユーザー: この動画の英語/日本語字幕を両方抽出して
Claude:
1. --list-subsで利用可能な言語を確認
2. 各言語の字幕をダウンロード
3. 整理されたテキストファイルを提供
エラーハンドリング
| エラー | 原因 | 解決策 |
|---|---|---|
yt-dlp not found | 未インストール | brew/apt/pipでインストール |
No subtitles available | 字幕なし | Whisperの使用を提案 |
Invalid URL | URLエラー | URL形式を確認 |
Video unavailable | 非公開/削除 | ユーザーに通知 |
Whisperフォールバック
字幕が全くない場合(ユーザーの確認が必要):
# ファイルサイズを確認
yt-dlp --print filesize "VIDEO_URL"
# ユーザーの承認後に音声をダウンロード
yt-dlp -x --audio-format mp3 "VIDEO_URL"
# Whisperで変換
whisper audio.mp3 --language ja --model base
注意: 帯域幅/処理時間を要するため、ユーザーの確認が必須です。