subtitles

subtitles 技能為 AI 代理程式提供透過 TranscriptAPI 獲取 YouTube 逐字稿資料的直接且高效的途徑。對於需要處理影片語音內容且不希望依賴繁重的瀏覽器自動化或不穩定的爬蟲工具的用戶來說，此技能至關重要。它專為學生、研究人員、內容創作者及開發人員設計，無論是為了生成摘要、製作學習輔助工具，還是為聽障人士提供無障礙功能，皆能滿足需求。

• 使用簡單的 API 端點擷取任何公開 YouTube 影片準確且帶有時間軸的字幕片段。
• 支援純文字輸出（適合翻譯與摘要任務）以及結構化的 JSON 格式（適合同步閱讀或字幕應用）。
• 允許選擇性包含元數據，例如影片標題、頻道名稱及影片說明。
• 與主流 AI 代理框架無縫整合，僅需標準 API 金鑰即可完成身份驗證。
• 處理多語言自動產生的字幕，讓用戶能輕鬆理解外語內容。

使用注意事項與技術細節：

• 需要有效的 TRANSCRIPT_API_KEY。該技能包含自動化流程，可在首次運行時協助用戶註冊或配置憑證。
• 嚴格要求正確配置 User-Agent 標頭，以防止 Cloudflare 403 封鎖並確保連線穩定。
• 本工具僅限於獲取字幕與逐字稿，不支援帳號管理、影片上傳或 YouTube 管理功能。
• API 採用信用額度系統，並為個人或開發者提供免費額度。
• 若您正在開發需要即時播放同步或標註特定語音時刻的應用程式，請使用帶時間軸的格式。
• 進行大量處理時，用戶可結合其他 YouTube 相關技能，獲取整個頻道或播放清單的逐字稿，這使其成為對影片資料庫進行深度研究的強大工具。