mcp-google-ads-transparency-monitor

Google Ads Transparency Monitor MCP サーバー

Apify 上の Mamba Labs Google Ads Transparency Monitor アクター用 MCP サーバーです。企業のドメインまたは広告主名を指定すると、実行ごとに Google の公開 Ads Transparency Center を読み取り、広告ごとに1行を返します。各行には形式、初回および最終表示日、クリエイティブへのリンク、広告のページが含まれます。また、Google による広告件数の範囲を含む企業サマリー行も返します。

内容

• できること
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• ご自身のキー
• アクターの完全なドキュメント
• ライセンス

できること

企業が掲載している Google 広告を一覧表示します。企業のドメイン（例：stripe.com）または広告主名、あるいはそれぞれのリストを指定します。広告ごとに、広告主、広告 ID、形式（テキスト、画像、動画）、初回および最終表示日、クリエイティブへのリンク、広告の Transparency Center ページを含む行が返されます。さらに、入力ごとにサマリー行が1つ返され、企業が Google 広告を掲載しているか、掲載件数（Google 独自の件数範囲。例：8,000～9,000件）、掲載形式が示されます。広告がない場合、リクエストがブロックされた場合、または Google のページが変更された場合も、row_status にその旨を記載した行が無料で返されます。

すべての処理は Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す薄いクライアントです。

クイックスタート

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

以下を Claude Desktop の設定（claude_desktop_config.json）、Cursor、または任意の MCP クライアントに追加します。

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

クライアントを再起動します。get_google_ads ツールが表示されます。

前提条件

• Node.js 18 以降。
• console.apify.com/account/integrations で取得した Apify API トークンを APIFY_TOKEN として設定します。サーバーはトークンがなくてもツールを一覧表示しますが、ツールを呼び出すにはトークンが必要です。

プロンプトの例

• 「notion.so は Google 広告を掲載していますか？件数と形式を教えてください」
• 「HubSpot が米国で掲載した動画広告のうち、最近の10件を表示してください」
• 「stripe.com、ramp.com、brex.com のうち、過去30日間に Google で広告を掲載したのはどの企業ですか？」

ツール

get_google_ads。ツールは1つです。引数の例：

{
  "company_domain": "stripe.com",
  "max_ads": "20",
  "since_days": "90"
}

入力

ライブアクターに渡すすべての購入者向け入力が対象です。変更せずに使用します。省略した入力には、アクター独自のデフォルト値が適用されます。company_domain、advertiser_name、domains、advertiser_namesのいずれかを指定してください。

入力	型	必須	説明
company_domain	string	いいえ	会社のウェブサイトのドメインです。例：stripe.com
advertiser_name	string	いいえ	Google が認証する広告主名です。例：Stripe, Inc.
domains	array	いいえ	複数の会社ドメインです。1 回の実行につき最大 500 件の入力を指定できます。
advertiser_names	array	いいえ	複数の広告主名です。
region	string	いいえ	anywhere、または US、GB、DE、FR などの 2 文字の国コードです。デフォルトは anywhere です。
formats	array	いいえ	text、image、video です。すべての形式を対象にする場合は省略します。
max_ads	string	いいえ	入力ごとの広告行数です。1～1000 を指定できます。デフォルトは 50 です。
since_days	string	いいえ	指定した日数以内に最後に表示された広告のみを対象にします。すべての広告を対象にするには 0 を指定します。デフォルトは 90 です。
include_summary	string	いいえ	true または false です。デフォルトは true です。
max_charge_usd	string	いいえ	実行に対する任意の料金上限です。
skipCache	string	いいえ	true の場合、無料の 24 時間キャッシュではなく最新の結果を読み込みます。デフォルトは false です。
proxy_mode	string	いいえ	auto、direct、residential です。デフォルトは auto です。

料金

Apify のイベントごとの従量課金で、Apify アカウントに請求されます。料金は USD です。

イベント	無料プラン	Bronze	Silver	Gold
ad-found、返された広告行ごと	$0.002	$0.0019	$0.0018	$0.0017
company-summary、広告のある入力ごと	$0.003	$0.00285	$0.0027	$0.00255
apify-actor-start、実行開始ごと	$0.0005	$0.0005	$0.0005	$0.0005

広告のない行、ブロックされた行、変更されたソース行、エラー行、キャッシュされた行は無料です。

キー

このアクターにプロバイダーキーは必要ありません。Google の公開 Ads Transparency Center を読み込み、独自のキーは保持しません。実行で Apify プロキシを使用しても、そのトラフィックによって料金が増えることはありません。Mamba Labs が実行のプラットフォームコストを負担します。proxy_modeは信頼性を設定する項目です。

アクターのドキュメント全文

apify.com/mambalabs/google-ads-transparency-monitor

ライセンス

MIT です。LICENSEをご覧ください。