Meta 広告

Meta 広告ノードは、Meta の公開広告ライブラリを検索し、条件に合う Facebook と Instagram の広告を JSON リストとして返します。各広告には、広告主のページ、広告文、見出し、CTA、リンク先、画像と動画のリンク、配信期間、現在も配信中かどうかが含まれます。リストをテキスト生成 - あらゆる LLMノードに接続すると競合分析ができ、フィールドを抽出に接続すると広告ごとに 1 回ずつ生成を実行できます。

使いどころ

• キーワード検索で、競合が商品カテゴリーをどう広告しているかを調べる。
• 広告主や Facebook ページを指定して、特定のブランドの最新クリエイティブを追う。
• 実際の広告文やビジュアルからクリエイティブのワークフローを始め、アレンジする。
• スケジュールトリガーで、新しい広告のまとめを定期的に受け取る。

クイックスタート

検索方法

キーワードと Facebook ページの URL の欄には {} を使えます。キーワード／ページ URL 入力に接続したノードのテキストが {} に入るため、テキストノードやリストノードで検索を動かせます。

広告主モードでは、広告主を選ぶ代わりに、テキストノードやリストノードを入力に接続することもできます。その場合、ノードの実行時に各行が Facebook ページに照合されます。認証済みの候補があればそれを、なければ最初の候補を使います。見つかったページは、結果の resolvedAdvertisers に記録されます。

設定

入力

出力

メインの広告とは、ノードカードに表示されている広告です。サムネイルの列、‹ › の矢印、または結果タブの行のクリックで選びます。ワークフローの実行では、最初に返ってきた広告がメインになります。

JSON 出力の各広告には、次のフィールドがあります。

{
  "adArchiveId": "866569929827744",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=866569929827744",
  "pageName": "Nike",
  "pageId": "15087023444",
  "startDate": "2026-09-01T07:00:00.000Z",
  "endDate": null,
  "isActive": true,
  "platforms": ["FACEBOOK", "INSTAGRAM"],
  "text": "Just do it.",
  "title": "Air Max",
  "caption": "nike.com",
  "ctaText": "Shop now",
  "linkUrl": "https://nike.com/airmax",
  "images": ["https://…/creative.jpg"],
  "videos": ["https://…/creative.mp4"],
  "videoPreviews": ["https://…/poster.jpg"],
  "collationCount": 3
}

各広告には format と creatives のリストもあり、各クリエイティブの種類、リンク、サイズ、形式が入っています。AI 分析がオンのときは、分析された各広告に、分析結果をまとめた analysis オブジェクトが付きます。

結果

ノードカードには広告が 1 件表示されます：クリエイティブ、広告主、見出し、広告文、形式、プラットフォーム、配信期間、CTA。設定パネルの結果タブには、すべての広告がリスト、グリッド、生の JSON の表示で一覧され、形式で絞り込むこともできます。各行は、広告ライブラリにあるその広告のページにリンクしています。

何も返らなかった実行や失敗した実行では、ノードは前回の正常な結果を残します。入力を変えると、それらの結果は次の実行まで古いものとして表示されます。

ライブラリのクリエイティブ

Meta の画像と動画のリンクは数日で期限切れになります。ノードは実行のたびに、返ってきた各広告の画像と動画のポスターをライブラリにコピーします。これらはストレージの使用量に含まれ、広告のライブラリに保存をクリックするまでメディアピッカーには表示されません。

動画はサイズが大きいため、メインの広告の動画はクリエイティブ動画出力が接続されているときだけコピーされます。返ってきたすべての広告の動画をコピーするには、すべての動画をライブラリにコピーをオンにします。ストレージがいっぱいのときは、広告は期限切れになる元の Meta のリンクのままになりますが、実行は成功します。その場合は、リンクを保存せず、同じワークフローの中でクリエイティブを使ってください。

クレジット

料金は、リクエストする広告の数で決まります：ソースごとの広告数×ソースの数を、次の段階に切り上げた数です。キーワード検索は 1 ソースで、ページや選んだ広告主はそれぞれ 1 ソースです。正確な料金は、実行する前にノードの実行ボタンに表示されます。

• リクエストした数に料金がかかります。 期間が短い場合やキーワードに合う広告が少ない場合は、返る広告がリクエストより少なくなることがあります。
• AI 分析では、広告ごとに料金が加わります。 料金は分析モデルの段階（エコノミー、スタンダード、プレミアム）で決まります。リクエストした数の分が確保され、実際に分析された広告の分で精算されます。モデルが分析に失敗した広告や、長い実行で時間が足りなくなった広告の分は返還されます。
• 入力から広告主を受け取る場合。 テキストノードやリストノードが広告主の名前を渡す場合、ソースの数はノードの実行時にしか分かりません。それまで、ノードの見積もりは 1 ソースとして計算します。
• 広告主の検索は無料です。

セルフホスティング環境では、Meta 広告ノードに、プロバイダーキーで説明している Web スクレイピング用のキーか、Nodaro Cloud への接続が必要です。

ヒント

• 終了したクリエイティブを研究する。 広告のステータスを非アクティブにし、期間を長くすると、広告主がすでに配信を止めた広告を見られます。
• 広告ごとに展開する。 リストノードの前にフィールドを抽出で images や text を取り出すと、広告ごとに 1 回ずつ生成を実行できます。
• 動画のポスターを使う。 ブランドの動画広告の videoPreviews は、新しいコンセプトのリファレンスフレームに向いています。

トラブルシューティング

API から

POST /v1/meta-ads-scrape で、コードからノードを実行できます。API のモードはキーワード検索とページの 2 つです。選んだ広告主は、その Facebook ページのアドレスとして送ってください。すべての動画をコピーし、すべての広告を分析する実行は、1 回の HTTP リクエストの上限である約 100 秒を超えることがよくあるため、"respondAsync": true を送ってください。この場合、呼び出しはすぐに jobId を返します。広告は、完了したジョブから GET /v1/jobs/:id で読み取ります。

このフラグがない場合、リクエストは実行が終わるまで開いたままです。リクエストの上限を超えた実行は、ジョブが完了して料金がかかっても、返す途中で切断されます。単体のノードを実行するとジョブを参照してください。