youtube-transcript

YouTube 逐字稿

使用 youtube-transcript-api 從 YouTube 影片擷取逐字稿。

使用方法

使用 YouTube 網址或影片 ID 執行腳本：

uv run scripts/get_transcript.py "VIDEO_URL_OR_ID"

含時間戳記：

uv run scripts/get_transcript.py "VIDEO_URL_OR_ID" --timestamps

預設值

• 不含時間戳記（預設）：純文字，每行一個字幕片段
• 含時間戳記：[MM:SS] text 格式（較長影片使用 [HH:MM:SS]）

支援的網址格式

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://youtube.com/embed/VIDEO_ID
• 原始影片 ID（11 個字元）

輸出

• 重要：你絕對不能修改回傳的逐字稿
• 如果逐字稿不含時間戳記，你應該清理它，使其按完整段落排列，且句子不會在中間被截斷。
• 如果被要求將逐字稿儲存到特定檔案，請儲存到指定的檔案。
• 如果未指定輸出檔案，請使用 YouTube 影片 ID 加上 -transcript.txt 後綴。

備註

• 擷取自動產生或手動新增的字幕（以可用的為準）
• 需要影片已啟用字幕功能
• 如果沒有手動字幕，則回退到自動產生的字幕