RevClamp AdPulse - Google Ads Transparency Scraper & MCP

RevClamp AdPulse - Google Ads Transparency Scraper & MCP

免責事項： RevClamp が提供する独立したインテリジェンスツールです。Google LLC とは提携しておらず、同社による推奨も受けていません。

ブラウザーや住宅用プロキシを使わず、Google Ads Transparency Center（adstransparency.google.com）から、確認済みの Google Ads 広告主エンティティを検索し、配信中または過去の広告クリエイティブ（テキスト、画像、動画）、プレビューリンク、配信日を直接取得します。Apify Pay-per-Event Actor と Model Context Protocol（MCP）サーバー（@revclamp/google-ads-transparency-mcp-actor）の両方で利用できます。

• 正式な提供元ウェブサイト： https://revclamp.com
• 公式 MCP パッケージ： @revclamp/google-ads-transparency-mcp-actor（com.revclamp/google-ads-transparency-mcp-actor）

主な機能

1. 広告主エンティティのスマートマッチング（SearchSuggestions）：
   • 国際化ドメイン（nike.com、stripe.com、shopify.co.uk、brand.myshopify.com、on-running.com、bankofamerica.com、thenorthface.com）や複数語・Unicode のブランド検索語（CJK／ハングルの企業名、「The Coca-Cola Company」、「L'Oréal」）を、確認済みの Google Ads Transparency の法的エンティティ（AR...）に照合します。
   • nike.com を検索したときに Nike, Inc.（AR16735076323512287233）ではなく NIKETA'S COMPANY S.R.L. が選ばれるような部分文字列による誤一致を防ぎます。また、先頭語が一致する場合に限る厳格な同一性チェックを適用するため、中央の単語だけが一致する候補（Big Apple Pizza LLC）や、先頭の単語だけが同じ無関係な企業（Nike AI Solutions）が企業の子会社として誤って含まれることはありません。
   • 地域子会社の追加に対応します（includeSubsidiaries: true。Stripe, Inc.（米国）と Stripe Payments Europe, Limited（アイルランド）など、確認済みの地域企業エンティティを最大 3 件含められます）。
2. ページネーション対応のクリエイティブとアセットの抽出（SearchCreatives と LookupService/GetCreativeById）：
   • ISO-2 の countryCode フィルターを Google Ads の地域ターゲット条件 ID に対応付け（US -> 2840、GB -> 2826、DE -> 2276、SG -> 2702、VN -> 2704）、正規化された TEXT、IMAGE、VIDEO 広告クリエイティブを抽出します。抽出される項目は、デコード済みの previewUrl、archiveImageUrls、firstSeenAtIso、lastSeenAtIso、daysActive、timestampsRepaired、regionalPresence、transparencyUrl です。
   • 不透明な継続カーソル（rcp1_...、maxLength: 2048。クエリスコープのハッシュ qh、生のページ長 rl、アンカーとなる creativeId ac を含む）を使い、ページ途中からの再開に対応します。また、maxResults、Apify の CHARGE_LIMIT_REACHED、DEADLINE_EXCEEDED_BEFORE_CHARGE、または MCP レスポンスの 30,000 バイト上限によってページが切り詰められた場合は、pagination.nextPageToken を自動的に巻き戻します。重複課金やクリエイティブの取りこぼしなく再開するには、返された pagination.nextPageToken を次回の Actor 入力または MCP ツール呼び出しで pageToken として渡してください。
3. 課金ゼロのスキーマガード、レート制限対策、クラッシュセーフな Apify 課金処理：
   • 正当な空の結果（EMPTY_RESULT）と、上流の HTTP エラー（UPSTREAM_ERROR）、レート制限／CAPTCHA チャレンジ（UPSTREAM_RATE_LIMITED）、protobuf-JSON スキーマの変更（SCHEMA_DRIFT_HALT）を区別し、Pay-per-Event の課金が発生する前に処理を停止します。
   • Apify Cloud とネイティブに統合します（ACTOR_RUN_ID、ACTOR_DEFAULT_DATASET_ID、ACTOR_DEFAULT_KEY_VALUE_STORE_ID、ACTOR_MEMORY_MBYTES を使用し、従来の APIFY_* エイリアスにフォールバックします）。すべての終了経路で、実行サマリーと pagination.nextPageToken を標準出力に加えてデフォルトの Key-Value Store の OUTPUT レコードに書き込みます。また、上限付きの pushData 再試行を行いながら、inFlightIds、chargedIds、deliveredIds、unknownOutcomeIds、stagedItemsById を追跡することで、一時的な障害や同一実行内での再開時に二重課金や課金済みペイロードの消失を防ぎます。

CLI と検証

# Run MCP stdio server
npx @revclamp/google-ads-transparency-mcp-actor --mcp-stdio

# Start local interactive web playground on http://127.0.0.1:4410
npm run playground

# Run full unit, golden-corpus, metamorphic, mutation, and CDP E2E test suites
npm test

利用規約、データの出所および独立したツールに関する免責事項

• 公開透明性記録のみ： RevClamp AdPulse は、調査、ブランドセーフティ監査、規制遵守、および競合広告の分析を目的として、Google Ads Transparency Center（adstransparency.google.com）で公開されている、一般にアクセス可能な透明性情報を照会します。
• 回避行為および個人データの不使用： このツールは、認証を必要としない公開透明性エンドポイントのみを厳格に利用し、許可するホスト名を厳密に限定し（adstransparency.google.com、displayads-formats.googleusercontent.com、tpc.googlesyndication.com）、送信時に Cookie と認証情報を削除します。また、上流側のレート制限または CAPTCHA チャレンジ（HTTP 429 / /sorry/）を検出した場合は、直ちに停止します（UPSTREAM_RATE_LIMITED）。
• 商標および提携に関する告知： 「Google」および「Google Ads」は Google LLC の商標です。RevClamp AdPulse は RevClamp が開発した独立したソフトウェアツールであり、Google LLC との提携、同社による支援または承認を受けていません。

ライセンス

MIT © RevClamp Enterprise