> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.beatapi.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server. # n8n で BeatAPI を使う > BeatAPI のモデルとデータを n8n に接続し、検証済みの範囲を把握したうえで用途別のワークフローをインポートします。 # n8n で BeatAPI を使う 用途に合った接続方法を選んでください。モデル用の認証情報、HTTP ワークフロー、公開された n8n テンプレートは、それぞれ別のものです。 | 用途 | n8n の接続方法 | BeatAPI の接続先 | | ------------------------------- | -------------------------------------- | ---------------------------------------------------------- | | AI Agent または LLM Chain でのテキスト処理 | 標準の OpenAI Chat Model | `https://api.beatapi.io/v1` と `GET /v1/models` で取得した正確な ID | | Social Data または Web 調査 | Header Auth を設定した HTTP Request | 詳細を確認した機能、または文書化された Data/Web エンドポイント | | 画像、動画、ミュージックビデオ | HTTP Request、Wait、回数や時間を制限したステータス確認ループ | 一度だけ作成し、タスク ID を保存してからステータスをポーリング | ## 認証情報を設定する OpenAI Chat Model では、BeatAPI のキーとベース URL `https://api.beatapi.io/v1` を指定した OpenAI 認証情報を作成します。HTTP Request ノードでは、ヘッダー名を `Authorization`、値を `Bearer ` とした Header Auth 認証情報を作成します。実際のキーは n8n の認証情報に保存し、エクスポートする JSON に含めないでください。 ## ワークフローをインポートする [BeatAPI の n8n サンプル](https://github.com/BeatAPI/beatapi-examples/tree/codex/n8n-capabilities/integrations/n8n)には、機能実行ワークフロー、公開 Social Data を調査する 3 つのワークフロー、ミュージックビデオワークフローがあります。現在の Social Data の変更は [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20) にあります。この PR はレビュー対象の変更であり、マージ済みのリリースや n8n Marketplace の掲載ではありません。 1. ワークフローの JSON をダウンロードし、n8n にインポートします。 2. **Configure Inputs** を開き、サンプル値を置き換えます。 3. すべての BeatAPI HTTP Request ノードに Header Auth 認証情報を割り当てます。 4. 有料の実行前に、選択した機能の入力、出力、料金、実行手順を確認します。 5. 一度テスト実行し、n8n の実行 ID とともに BeatAPI のリクエスト ID またはタスク ID を保存します。 非同期処理では、課金対象のタスクを再作成せずにステータスの取得だけを再試行します。成功、失敗、または所定のタイムアウトでループを終了してください。n8n のタイムアウトだけでは、BeatAPI のタスクが失敗したとは判断できません。 ## 検証状況 2026 年 9 月 26 日時点で、3 つの Social Data JSON ファイルはローカルの n8n インスタンスにインポート済みです。X のキーワードワークフローはローカルの n8n で実行を完了しました。Instagram と YouTube は API とインポートの検証を行いましたが、n8n での一連の実行は完了していません。X のテンプレートは、担当者による審査のため n8n Creator Portal に提出済みです。最新の配布状況は [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20) と n8n のテンプレートディレクトリで確認してください。 これらのサンプルは標準ノードだけで利用できます。BeatAPI 専用の n8n コミュニティノードは公開していません。