mcp-meta-ad-library-monitor

Meta Ad Library Monitor MCP サーバー

Meta Ad Library API を通じて、企業が配信中の Facebook および Instagram 広告を見つける MCP サーバーです。Apify 上の Mamba Labs Meta Ad Library Monitor アクターをラップし、あらゆる MCP クライアントに Clay 対応のフラットな JSON 行を返します。

内容

• 機能
• クイックスタート
• 前提条件
• プロンプトの例
• 入力
• 出力
• 出力例
• 機能
• 料金
• アクターの完全なドキュメント
• Mamba Labs GTM Suite
• ライセンス

機能

企業名またはドメインと、ご自身の Meta アクセストークンを指定すると、Meta Ad Library を検索し、広告ごとにフラットな行を 1 つ返します。行には、クリエイティブのテキスト、見出し、配信期間、広告が掲載された Meta サービス、および広告のレンダリング結果を確認できる Meta の永続的なスナップショット URL が含まれます。

このツールが役立つかどうかは対象範囲によって決まるため、まず対象範囲をご確認ください。このツールは Meta が認めている唯一の方法である Meta の Ad Library Graph API を読み取ります。この API が公開するのは、EU の利用者に配信されたすべての広告（内容を問わない）と、世界中の社会問題、選挙、政治に関する広告の 2 種類です。そのため、EU の企業を多く含むリストでは一般的な商業広告を広く取得できますが、米国や英国の一般的な商品広告のリストでは、大半が not_found になります。これは検索機能の不具合ではなく、Meta のデータセットによるものです。各行には、検索で取得可能な内容を示す対象範囲の注記が付いています。インプレッション数と広告費は政治広告のみで提供され、範囲として表示されるため、値が null でも広告費がゼロという意味ではありません。

検索はすべて Apify 上で実行されます。このパッケージはアクターを呼び出し、結果を変更せずに返す薄いクライアントです。

クイックスタート

Node.js 18 以降と、API トークンを持つ Apify アカウントが必要です。

以下を Claude Desktop の設定に追加してください。

{
  "mcpServers": {
    "mamba-meta-ad-library-monitor": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-meta-ad-library-monitor"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

https://console.apify.com/account/integrations でトークンを取得して貼り付け、Claude Desktop を再起動してください。find_meta_ads ツールが利用可能になります。

また、独自の Meta アプリのアクセストークンも必要です。developers.facebook.com で無料で作成できます。チャットの文字起こしにトークンが含まれないよう、同じ env ブロックで META_ACCESS_TOKEN として設定するか、呼び出しごとに metaAccessToken ツール引数として渡してください。どちらも指定しない場合、Apify の実行が始まる前にツールがエラーを返すため、トークンがないことで費用が発生することはありません。

前提条件

• Node.js 18 以降
• API トークンを持つ Apify アカウント
• 独自の Meta アプリのアクセストークン。developers.facebook.com で無料で取得できます。Ad Library API は公開されていないため、これは必須です。
• 政治広告や社会問題に関する広告データが必要な場合は、Meta アカウントで本人確認が済んでいる必要があります。これは Meta の要件であり、当社の要件ではありません。

プロンプトの例

• 「gymshark.com は現在、EU で Facebook 広告を出していますか？Meta トークンはこちらです。」
• 「この会社の、EU のオーディエンス向けに現在配信中の広告を、新しい順に25件表示してください。」
• 「この広告主の動画広告のみ、配信中と配信終了済みの両方を探してください。」
• 「英国でこのブランドの Meta Ad Library を検索して、カバレッジに関する注記の内容を教えてください。」

入力

• company_domain（任意）：例として gymshark.com のような、会社のドメイン名のみを指定します。会社名が指定されていない場合、広告主の検索語句を導き出すために使用されます。また、一致した広告主ページが実際にこの会社のものかを本人確認ゲートが検証する際にも使用されます。
• company_name（任意ですが、強く推奨）：Meta の広告主検索はページ名を対象としたあいまい検索であるため、本人確認ゲートでは会社名と一致したページを照合します。指定がない場合、ゲートはドメイン名の本体部分を代わりに使用しますが、精度は下がります。
• metaAccessToken（META_ACCESS_TOKEN がサーバー環境に設定されていない場合は必須）：独自の Meta アプリのアクセストークンです。developers.facebook.com で無料で作成できます。Ad Library API は公開されていないため、どちらも指定せずに呼び出すとエラーになり、実行は開始されません。
• ad_reached_countries（任意）：検索する国別のオーディエンスを指定します。EU、GB、US、DE、FR、NL、ES、IT、IE、ALL_EU_PLUS_UK のいずれかを指定してください。Meta はこのパラメーターを必須としており、指定しないリクエストは失敗します。EU は Ad Library が政治広告だけでなくすべての広告を対象としている地域のため、デフォルト値になっています。
• ad_active_status（任意）：ACTIVE、ALL、INACTIVE のいずれかを指定します。現在配信中の広告が購買シグナルとなるため、デフォルトは ACTIVE です。クリエイティブの履歴や競合の詳細な分析には ALL を指定します。
• ad_type（任意）：ALL を指定すると、その国で Ad Library が保有するすべての広告が返されます。POLITICAL_AND_ISSUE_ADS を指定すると、政治広告アーカイブに絞り込まれます。インプレッション数と広告費が含まれるのはこのアーカイブのみで、Meta アカウントの本人確認が必要です。
• media_type（任意）：ALL、IMAGE、VIDEO、MEME、NONE のいずれかを指定します。動画だけを対象にしたいクリエイティブ分析に便利です。
• maxAds（任意）：会社ごとに返す広告行の数です。10、25、50、100 のいずれかを指定します。これは回答の内容を変えるものではなく、費用を調整するための設定です。上限に達する前に一致した広告の件数は、常に行に記載されます。
• skipCache（任意）：false（デフォルト）の場合、成功した検索結果は7日間キャッシュされ、再利用されます。最新の結果を取得するには true を設定してください。
• max_charge_usd（任意）：この呼び出しの支出上限を米ドルで指定します。実行額がこの金額を超える課金の前に Actor が停止し、すでに課金されたすべての行は保持されます。

出力

このツールは、Actor のフラットな JSON 行を広告ごとに返します。形式は snake_case で、ネストされたオブジェクトはありません。advertiser_match は広告主ページがどのように照合されたかを示し、advertisers_rejected は本人確認ゲートで除外された広告主の数を示します。coverage_note は検索で見つかる可能性があった内容を示すため、結果が空の場合も内容を判断できます。impressions と spend が設定されるのは政治広告と社会問題に関する広告のみです。出力スキーマの全容については、Apify Store のページをご覧ください。

出力例

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "gymshark.com",
  "company_name": "Gymshark",
  "page_id": "102590181603009",
  "page_name": "Gymshark Women",
  "advertiser_match": "name_match",
  "advertisers_rejected": 9,
  "ad_id": "2824771397896004",
  "ad_creative_body": "Hol dir die soften, leichten Gymsets fürs Training (und den chaotischen Alltag) ✨",
  "ad_creative_link_title": "Everyday Seamless ab 30 € 💸",
  "ad_creation_time": "2026-08-21",
  "ad_delivery_start_time": "2026-08-21",
  "ad_delivery_stop_time": null,
  "ad_snapshot_url": "https://www.facebook.com/ads/library/?id=2824771397896004",
  "publisher_platforms": "facebook, instagram, audience_network, messenger, threads",
  "languages": "de",
  "impressions": null,
  "spend": null,
  "currency": null,
  "ads_matched": 10,
  "coverage_note": "Searched EU audiences, where the Ad Library covers all ads, plus non EU audiences where it covers only political and issue ads. A commercial advertiser outside the EU is legitimately absent.",
  "coverage": 1,
  "fetch_status": "ok",
  "run_date": "2026-08-23T05:50:09.867Z"
}

機能

• 広告ごとに1行で、クリエイティブのテキスト、見出し、配信日を表示します
• レンダリングされた各広告に対する、Meta 独自の永続的なスナップショット URL
• 広告が配信された Meta の各サーフェスを publisher_platforms に表示します
• Meta が認めた Ad Library Graph API のみを読み取り、ほかの経路は使用しません
• 結果が空でも内容が分かるよう、すべての行に網羅状況の注記を付けます
• 広告主の本人確認ゲートがあり、却下された候補の件数も記録します

料金

Apify ではイベントごとに料金が発生し、ご自身の Apify アカウントに請求されます。2026-10-16 に読み取った最新の料金記録に基づく料金は次のとおりです。

イベント	イベントあたりの料金（USD）	発生条件
apify-actor-start	$0.00005	Actor の実行開始時に課金されます。課金されるイベント数は Actor のメモリ量に応じて決まり、1 GB あたり1イベント、最低1イベントです。
advertiser-checked	Free プランでは $0.004、上位の Apify プランでは $0.0028 まで	Ad Library を検索し、劣化していない結果が得られた会社ごとに1回発生します。広告が見つかったかどうかは問いません。広告がない広告主についても、検索して何も見つからないことは正当な回答であり、依頼された作業であるため、1回発生し、それ以外の課金はありません。検索が実行されなかった劣化行では発生しません。
ad-returned	Free プランでは $0.002、上位の Apify プランでは $0.0014 まで	本人確認ゲートを通過した後、実際に返された広告の行ごとに1回発生します。ゲートを通過できなかったページに属する広告は返されず、課金もされません。作業は実施済みであり、それらの広告はこの会社のものではないというのが正確な回答です。

Actor の Apify ページに最新の料金が掲載されています。このサーバーを実行すると Apify クレジットを消費します。

Actor の完全なドキュメント

このサーバーは薄いクライアントであり、検索ロジックは保持していません。入力と出力の完全なリファレンス、料金、実行履歴については、Apify Store のページをご覧ください。

https://apify.com/mambalabs/meta-ad-library-monitor

---

Mamba Labs GTM Suite

このサーバーは、Mamba Labs GTM Suite の MCP サーバーの1つです。スイート内の各 Actor はドメインまたは会社を受け取り、整形し直すことなく同じ Clay テーブルに追加できる、フラットな1行を返します。このサーバーの基盤となる Actor は Meta Ad Library Monitor で、変更不可の Apify Actor ID は J1GWlSXfSGU3u8Wng です。

Mamba Labs が開発 | npm | Apify Store

ライセンス

MIT

Mamba Labs が開発。https://apify.com/mambalabs