YouTube 字幕下載器
此技能用於從 YouTube 影片中提取和處理字幕。
優先順序
1. 確認 yt-dlp 是否已安裝
2. 檢查可用的字幕列表
3. 優先嘗試手動字幕
4. 回退使用自動生成字幕
5. 最終手段:Whisper 轉換
需求
# macOS
brew install yt-dlp
# Linux
sudo apt install yt-dlp
# 通用
pip install yt-dlp
工作流程
步驟 1:檢查字幕列表
yt-dlp --list-subs "VIDEO_URL"
步驟 2:下載手動字幕(建議)
# 繁體中文字幕
yt-dlp --write-sub --sub-lang zh-TW --skip-download "VIDEO_URL"
# 英文字幕
yt-dlp --write-sub --sub-lang en --skip-download "VIDEO_URL"
步驟 3:自動生成字幕(回退)
yt-dlp --write-auto-sub --sub-lang zh-TW --skip-download "VIDEO_URL"
步驟 4:VTT 轉換為純文字
# 從 VTT 檔案移除時間戳
sed '/^[0-9]/d; /^$/d; /-->/d' subtitle.zh-TW.vtt > transcript.txt
輸出處理
去重
自動生成字幕因 progressive 字幕導致大量重複:
# 移除重複行
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 zh --model base
注意:會耗費大量頻寬和處理時間,必須先取得使用者確認