YouTube 內容工具
使用時機
當使用者分享 YouTube 網址或影片連結、要求摘要影片、索取逐字稿,或希望從任何 YouTube 影片中提取並重新格式化內容時使用。將逐字稿轉換為結構化內容(章節、摘要、討論串、部落格文章)。
從 YouTube 影片中提取逐字稿並轉換成實用的格式。
設定
使用 uv 將相依套件安裝到與輔助腳本相同的 Hermes 管理環境中:
uv pip install youtube-transcript-api
輔助腳本
SKILL_DIR 是包含此 SKILL.md 檔案的目錄。腳本接受任何標準的 YouTube 網址格式、短網址 (youtu.be)、Shorts、嵌入影片、直播連結,或原始的 11 字元影片 ID。
# JSON 輸出含元資料
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# 純文字(適合導向後續處理)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# 含時間戳
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# 指定語言及備用語言鏈
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
輸出格式
擷取逐字稿後,根據使用者要求格式化:
- 章節:按主題轉折分組,輸出附時間戳的章節列表
- 摘要:整部影片的簡潔概述(5-10 句話)
- 章節摘要:各章節附一段簡短摘要
- 討論串:Twitter/X 討論串格式——編號貼文,每則不超過 280 字元
- 部落格文章:含標題、章節和關鍵重點的完整文章
- 語錄:附時間戳的知名語錄
範例——章節輸出
00:00 開場 —— 主持人提出問題陳述
03:45 背景 —— 先前的研究及現有方案為何不足
12:20 核心方法 —— 逐步解說提出的方法
24:10 結果 —— 基準比較與關鍵重點
31:55 Q&A —— 觀眾針對擴展性與後續步驟提問
工作流程
- 擷取:使用輔助腳本搭配
--text-only --timestamps參數,透過uv run python3執行。 - 驗證:確認輸出內容非空且為預期語言。若為空,則移除
--language參數重試以取得任何可用逐字稿。若仍為空,告知使用者該影片很可能已停用逐字稿。 - 必要時分段:若逐字稿超過約 50K 字元,將其分割為重疊區塊(約 40K 字元,重疊 2K),分別摘要後再合併。
- 轉換:轉換為要求的輸出格式。若使用者未指定格式,預設為摘要。
- 驗證:再次閱讀轉換後的輸出,檢查連貫性、時間戳是否正確及完整性,再進行呈現。
錯誤處理
- 逐字稿停用:告知使用者;建議他們檢查影片頁面上是否有字幕可用。
- 私人/無法觀看的影片:回報錯誤,並要求使用者確認網址。
- 無符合的語言:移除
--language參數重試以取得任何可用逐字稿,然後告知使用者實際的語言。 - 缺少相依套件:執行
uv pip install youtube-transcript-api並重試。