YouTubeの文字起こしデータクリーナー＆抽出ツール - n8n ワークフロー

コンテンツの再利用のために、クリーンで構造化された書き起こしが必要なコンテンツ制作者。
動画コンテンツの感情分析やキーワード抽出を行うデータアナリスト。
動画データをAIパイプラインに統合するための堅牢なn8nテンプレートを探しているユーザー。
高品質な動画キャプションを必要とするカスタムツールを開発している開発者。

YouTube API（VTT形式）から直接ダウンロードした生のキャプションには、タイムスタンプ、ヘッダー、音声表記（例：[Música]）などのノイズが多く含まれており、そのままではAI処理や記事生成に使用できません。この専用n8nワークフローは、完全自動のクリーニングパイプラインを提供することで、この問題を解決します。

このn8nテンプレートはYouTube Data APIを利用してキャプションを検索・ダウンロードし、指定された言語を優先します。このn8nワークフローの核となる価値は、カスタムのCodeノードにあります。これらが専門知識を駆使してメタデータを剥ぎ取り、後続のアプリケーションですぐに使用できる、プレーンで可読性の高いテキスト形式の書き起こしを生成します。このn8nソリューションは、動画ライブラリからクリーンなデータを必要とするすべての人にとって不可欠であり、コンテンツ自動化のための最も実用的なn8nテンプレートの1つです。

重要な制限事項： YouTube APIの制限により、このn8nワークフローでキャプションを正常に抽出できるのは、認証されたYouTubeチャンネルに属する動画のみです。

このn8nワークフローは、文字起こしリクエストを処理するために外部からトリガーされる、非常に効率的なサブプロセスとして機能します。

1. 入力トリガー: プロセスはWhen Executed by Another Workflow（別のワークフローから実行されたとき）n8nトリガーによって開始され、youtubeVideoIdとオプションのpreferredLanguage（例：'es'）を受け取ります。これらの変数は直ちにSet Variables n8nノードによって保存されます。


2. APIクエリ: List Captions（キャプションを一覧表示）n8nノード（HTTPリクエスト）がYouTube Data APIに対してクエリを実行し、指定された動画IDで利用可能なすべてのキャプションデータトラックのリストを取得します。


3. 条件分岐: IF Has Captions?（キャプションの有無を確認）n8nノードがキャプションの存在（items.length > 0）を確認します。


4. 成功パス（キャプションが見つかった場合）:

1. 失敗パス（キャプションがない場合）: キャプションが存在しない場合、No Captions Fallback（キャプションなしのフォールバック）n8nノードが構造化されたエラーレスポンスを生成し、Stop and Error（停止とエラー）n8nノードがワークフローを正常に終了させ、後続の失敗を防ぎます。

この強力なn8nテンプレートをデプロイするには、次の手順に従ってください。

1. ワークフローのインポート: 提供されているJSONデータをコピーし、n8nインスタンスで「新規作成」ボタン -> 「JSONからインポート」を介してインポートします。


2. YouTube API認証情報: n8nで設定済みの有効なYouTube OAuth2認証情報が必要です。


3. 認証情報の更新: List CaptionsノードとDownload VTTノードを開きます。「認証」セクションで、「認証情報」フィールドを個人のYouTube OAuth2アカウントを使用するように更新します。

1. テスト: これがExecute Workflow Trigger（ワークフロー実行トリガー）を使用しているため、別の親n8nワークフローから実行するか、JSONペイロード（例：{"youtubeVideoId": "YOURVIDEOID", "preferredLanguage": "en"}）を使用して「ワークフローをテスト」機能を使用する必要があります。ビデオIDは認証されたチャンネルのものである必要があることに注意してください。

When Executed by Another Workflow (n8n Trigger): この再利用可能なモジュールの開始n8nトリガーポイントとして機能します。youtubeVideoIdとpreferredLanguageパラメータを受け取ります。
List Captions (HTTP Request n8n node): YouTube Data API（captions?part=snippet）に対して最初の呼び出しを実行します。YouTube OAuth2認証情報を使用して、動画で利用可能なすべてのキャプションデータトラックを一覧表示します。
IF Has Captions? (n8n node): コアとなるフロー制御メカニズムです。APIレスポンスの長さをチェックして動画にキャプションがあるかどうかを判断し、n8nワークフローを適切なパスに誘導します。
Caption Language Selector (Code n8n node): この重要なカスタムスクリプトn8nノードには、要求された言語を優先するためのJavaScriptロジックが含まれています。ダウンロードステップのために特定されたcaptionIdを保存します。
Download VTT (HTTP Request n8n node): 選択されたcaptionIdを使用して生のVTTファイルをダウンロードします。このファイルには、すべてのタイムスタンプとメタデータが含まれています。
Caption File Conversion (Extract From File n8n node): 前のHTTPリクエストから受信したバイナリVTTファイルを、使用可能な生のテキストコンテンツに変換し、クリーニングの準備をします。

• Clean Transcript (Code n8n node): 最終的な処理ステップです。この高度にカスタマイズされたn8nノードは、正規表現とフィルタリングを使用して、VTT固有のノイズ（タイムスタンプ、ヘッダー、効果音）を体系的にすべて削除し、空白を正規化して、クリーンですぐに使用できる出力書き起こしを提供します。