YouTube 影片逐字稿擷取器 (透過外部 API) - n8n 工作流程

• 需要將影片內容再利用的內容創作者。


• 對影片內容進行情感分析的資料科學家與分析師。


• 開發用於 AI 摘要的客製化 n8n 模板的開發人員。


• 任何需要可靠、非 OAuth 方式來擷取 YouTube 逐字稿的使用者。

這個專家級的 n8n 流程提供了一個簡化方案，可用來從公開的 YouTube 影片中獲取乾淨、結構化的逐字稿。與那些需要複雜的 YouTube 資料 API 憑證和 OAuth 設定的解決方案不同，此自動化流程利用了專用的外部逐字稿服務（youtube-transcript.io）。

整個 n8n 流程被設計成一個可重複使用的元件，由另一個主流程觸發，只需要傳入 youtubeVideoId 作為輸入。其核心價值在於使用客製化的 n8n 節點實作了穩健的解析與清理步驟，確保輸出的內容是標準化的、不含時間戳記的，隨時可用於進階的自然語言處理 (NLP) 或 AI 摘要任務。這套可靠的 n8n 節點序列，使其成為媒體流程整合方面效率最高的 n8n 模板之一。

此 n8n 流程的執行遵循一個五步驟流程，從資料導入開始，結束時得到結構化、清理後的文字或定義好的錯誤訊息：

1. 輸入觸發： 程序從 When Executed by Another Workflow（被另一個流程執行時）的 n8n 觸發器開始，這表示此子流程已被呼叫。它預期會將 youtubeVideoId 作為參數傳入。


2. 輸入設定： Set Variables（設定變數）n8n 節點會安全地儲存輸入的影片 ID，使其在後續的節點中易於存取。


3. API 請求： Get Transcript (YouTube Transcript API)（獲取逐字稿 (YouTube 逐字稿 API)）n8n 節點會向 youtube-transcript.io API 發送一個 POST 請求。請求內容包含影片 ID 在 JSON Body 中。它被設定為接收完整的回應文字（Full response as text），以求最高的穩健性。


4. 資料解析與驗證： Parse API Response（解析 API 回應）的 n8n 代碼節點負責處理 API 的輸出。它包含錯誤處理機制 (try/catch) 以進行解析，並嘗試擷取逐字稿文字，即便 API 的 JSON 回應結構略有不同。


5. 流程控制： IF Has Transcript?（若有逐字稿？）n8n 節點會根據擷取到的文字是否存在來導向流程。如果文字存在，則進入清理步驟；如果不存在，則進入錯誤處理。


6. 成功路徑 (清理)： Clean Transcript（清理逐字稿）的 n8n 代碼節點會移除所有不必要的詮釋資料，包括換行和過多的空白，並過濾掉像 [Music] 這類常見的轉錄提示。接著會回傳最終的乾淨文字以及計算出的指標（wordCount、charCount）。


7. 失敗路徑 (錯誤)： 如果找不到逐字稿，No Transcript Fallback（無逐字稿替代）的 n8n 代碼節點會建構一個錯誤負載 (error payload)，而 Stop and Error（停止並回報錯誤）n8n 節點會讓父級 n8n 流程能優雅地終止執行。

要使用這個 n8n 流程，請依照以下步驟操作：

1. 匯入： 複製提供的 JSON 代碼，並使用 n8n 介面的「新增」(New) 選單 -> 「從 JSON 匯入」(Import from JSON) 直接匯入到您的 n8n 實例中。


2. 憑證： 這個特定的 n8n 流程依賴 youtube-transcript.io API 的免費方案，對於簡單的 GET/POST 請求通常不需要 API Key，但請確保 Get Transcript (YouTube Transcript API) n8n 節點的設定符合您的配置需求。


3. 整合： 由於此流程使用 Execute Workflow（執行流程）n8n 觸發器，您必須使用「執行流程」(Execute Workflow) n8n 節點，從主要的 n8n 流程中呼叫它，並傳入 youtubeVideoId 作為輸入參數。

• When Executed by Another Workflow (n8n 觸發器)： 作為進入點，定義必需的輸入參數 youtubeVideoId。


• Set Variables (n8n 節點)： 標準化輸入資料，確保 youtubeVideoId 在整個 n8n 流程中都能輕鬆被引用。


• Get Transcript (YouTube Transcript API) (HTTP Request n8n 節點)： 向外部逐字稿服務發送一個 POST 請求。關鍵配置包含將方法設為 POST、URL 設為逐字稿 API 端點，並將回應設定為處理為「完整回應」(Full Response) 和「文字」(text)，以確保解析穩健性。


• Parse API Response (Code n8n 節點)： 這個關鍵的客製化 n8n 節點負責安全地解析 JSON，並標準化來自可能不同的 API 回應結構中的輸出欄位（text、language）。


• IF Has Transcript? (IF n8n 節點)： 一個邏輯閘，檢查前一個 n8n 節點擷取到的 text 欄位是否不為空 (non-null) 且非空字串 (non-empty)。


• Clean Transcript (Code n8n 節點)： 執行最終的文字清理（移除換行、過多的空白，以及 [Music] 的註解），並生成如字數（wordCount）和字元數（charCount）等有用的指標，完成 n8n 流程的成功輸出。


• Stop and Error (n8n 節點)： 確保如果找不到逐字稿，父級 n8n 流程會收到明確的失敗指示，從而避免靜默的執行錯誤。