# Meta 広告

> Meta の公開広告ライブラリをキーワード、広告主、Facebook ページで検索し、各広告の広告文、CTA、画像、動画を JSON として AI ノードに渡します。

Source: https://nodaro.ai/ja/docs/nodes/automate/meta-ads

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

- Found in: Automate › Get Content
- API type: `meta-ads-scrape`

## 使いどころ
- キーワード検索で、競合が商品カテゴリーをどう広告しているかを調べる。
- 広告主や Facebook ページを指定して、特定のブランドの最新クリエイティブを追う。
- 実際の広告文やビジュアルからクリエイティブのワークフローを始め、アレンジする。
- [**スケジュールトリガー**](https://nodaro.ai/docs/nodes/automate/schedule-trigger)で、新しい広告のまとめを定期的に受け取る。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**自動化 › コンテンツ取得 › Meta 広告**を選びます。

### 検索する対象を選ぶ
設定パネルを開き、**検索方法**で**キーワード**、**広告主**、**Facebook ページ**のいずれかを選びます。キーワードを入力するか、広告主を選ぶか、ページのアドレスを貼り付けます。

### 絞り込みを設定する
**ソースごとの広告数**、**期間**、**広告のステータス**を設定します。**実行**ボタンに、そのリクエストの料金が表示されます。

### 実行して広告を使う
**実行**をクリックします。ノードカードには広告が 1 件ずつ表示され、**結果**タブにはすべての広告が一覧表示されます。**JSON** 出力を[**テキスト生成 - あらゆる LLM**](https://nodaro.ai/docs/nodes/automate/prompt)ノードか[**フィールドを抽出**](https://nodaro.ai/docs/nodes/automate/extract-field)に接続します。

Workflow: 毎週月曜日、スケジュールトリガーがワークフローを実行します。Meta 広告が競合 3 社の新しい広告を取得し、テキスト生成 - あらゆる LLM ノードがそれを要約し、Telegram 投稿がその要約を送ります。

- Meta 広告 → テキスト生成 - あらゆる LLM (プロンプト)
- テキスト生成 - あらゆる LLM → Telegram 投稿

## 検索方法
| 方法 | 指定するもの | 動作 |
| --- | --- | --- |
| **キーワード** | **キーワード**（100 文字まで） | 広告の中の言葉を検索します。広告主の名前は検索しません。 |
| **広告主** | **広告主**（5 件まで） | 広告主の名前を入力して**検索**をクリックし、候補から正しい Facebook ページを選びます。たいていは認証済みのページが正解です。実行では、選んだ広告主の広告だけを取得します。この検索にクレジットはかかりません。 |
| **Facebook ページ** | **Facebook ページの URL**（5 件まで） | ページのアドレスを 1 行に 1 つずつ入力します。例：`https://www.facebook.com/nike`。`https://` は省略できます。広告主の広告ライブラリのリンクも使えます。 |

**キーワード**と **Facebook ページの URL** の欄には `{}` を使えます。**キーワード／ページ URL** 入力に接続したノードのテキストが `{}` に入るため、[**テキスト**](https://nodaro.ai/docs/nodes/automate/text)ノードや[**リスト**](https://nodaro.ai/docs/nodes/automate/list)ノードで検索を動かせます。

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

## 設定
| 設定 | 初期値 | 内容 |
| --- | --- | --- |
| **ソースごとの広告数** | 20 | キーワード、または各ページについて返す広告の数。1〜100。 |
| **期間** | **過去 30 日間** | **過去 24 時間**、**過去 7 日間**、**過去 30 日間**、**全期間**。広告の開始日で判定します。 |
| **広告のステータス** | **アクティブ** | **アクティブ**、**非アクティブ**、**すべて**。 |
| **国** | **すべての国** | 国を 1 つ選ぶと、その国で配信された広告だけを残します。 |
| **プラットフォーム** | 絞り込みなし | 選んだプラットフォームで配信された広告だけを残します：Facebook、Instagram、Audience Network、Messenger、WhatsApp、Threads。何も選ばない場合と 6 つすべてを選んだ場合は、絞り込みません。 |
| **クリエイティブの形式** | 絞り込みなし | クリエイティブが**縦型 · スマートフォン**、**正方形**、**横型 · Web** の広告だけを残します。形式はクリエイティブの実際のピクセルから判定します。返る広告がリクエストより少なくなることがあります。 |
| **AI 分析** | オフ | 返ってきた各広告を、広告分析の専門家として読み解きます：素材の種類、形式、視覚的なフック、ターゲット層、グラフィックの特徴、コピーのフック、セールスポイント、CTA、まとめ。**分析モデル**と、任意の**分析の観点（任意）**（たとえば自社の商品）を指定します。 |
| **すべての動画をライブラリにコピー** | オフ | メインの広告の動画だけでなく、返ってきたすべての広告の動画をライブラリにコピーします。 |

## 入力
| 入力 | 必須 | 接続するもの |
| --- | --- | --- |
| **キーワード／ページ URL** | いいえ | テキスト：**キーワード**モードではキーワード、**Facebook ページ**モードではページのアドレス（1 行に 1 つ）、**広告主**モードでは広告主の名前（1 行に 1 つ）。 |

## 出力
| 出力 | 内容 |
| --- | --- |
| **JSON** | 広告のリスト全体。[**リスト**](https://nodaro.ai/docs/nodes/automate/list)ノードや[**フィールドを抽出**](https://nodaro.ai/docs/nodes/automate/extract-field)で、広告ごとに 1 回ずつノードを実行できます。 |
| **広告文** | メインの広告の見出しと本文。 |
| **クリエイティブ画像** | メインの広告の最初の画像、またはその動画のポスター。 |
| **クリエイティブ動画** | メインの広告の最初の動画。 |

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

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

```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 広告ノードに、[プロバイダーキー](https://nodaro.ai/docs/self-hosting/provider-keys)で説明している Web スクレイピング用のキーか、[Nodaro Cloud への接続](https://nodaro.ai/docs/self-hosting/cloud-connect)が必要です。

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

## トラブルシューティング
| 問題 | 原因と対処 |
| --- | --- |
| キーワードで、関係のないブランドの広告が返る。 | **キーワード**は広告の中の言葉を検索し、広告主は検索しません。1 つのブランドを追うには、**広告主**か **Facebook ページ**を使ってください。 |
| **検索**で広告主が見つからない。 | ブランドの Facebook ページの正確な名前で試してください。 |
| 返った広告がリクエストより少ない。 | 期間、ステータス、または**クリエイティブの形式**の絞り込みで、条件に合う広告が少なくなりました。期間を広げるか、絞り込みを外してください。 |
| クリエイティブのリンクが使えなくなった。 | ストレージがいっぱいだったなどの理由でクリエイティブをライブラリにコピーできず、期限切れの Meta のリンクが残っていました。ノードをもう一度実行してください。 |

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

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

## よくある質問

### Meta 広告ノードは何を返しますか？

Meta の公開広告ライブラリから取得した広告の JSON リストを返します。各広告には、広告主のページ、広告文、見出し、CTA（行動を促すボタン）、リンク先、画像と動画のリンク、配信期間、現在も配信中かどうかが含まれます。

### 特定のブランドの広告だけを見られますか？

はい。「検索方法」を「広告主」にしてブランド名を入力し、「検索」をクリックして、その Facebook ページを選びます。広告主は 5 件まで選べます。または「検索方法」を「Facebook ページ」にして、ページのアドレスを 1 行に 1 つずつ、5 件まで貼り付けます。

### Meta 広告ノードの料金はいくらですか？

料金は、リクエストする広告の数（「ソースごとの広告数」×ソースの数）で決まり、段階ごとに切り上げられます。AI 分析をオンにすると、分析モデルの段階に応じて広告ごとに料金が加わります。正確な料金は「実行」ボタンに表示されます。

### リクエストした数より広告が少ないのはなぜですか？

期間が短い、キーワードに合う広告が少ない、または「クリエイティブの形式」で絞り込んだ場合は、見つかる広告がリクエストより少なくなることがあります。料金は、リクエストした数に対してかかります。

### 画像や動画のリンクは期限切れになりますか？

Meta のリンクは数日で期限切れになります。ノードは実行のたびに、各広告の画像と動画のポスターをライブラリにコピーするため、結果のリンクは使い続けられます。動画は、動画出力が接続されていればメインの広告の分が、設定をオンにすればすべての広告の分がコピーされます。