RevClamp AdPulse - Google Ads Transparency Scraper & MCP

RevClamp AdPulse - Google Ads 透明度抓取工具与 MCP

免责声明： RevClamp 提供的独立情报工具；与 Google LLC 无关联，也未获其认可。

直接从 Google Ads Transparency Center（adstransparency.google.com）查找经过验证的 Google Ads 广告主实体，并提取正在投放或历史广告创意（文本、图片、视频）、预览链接和投放日期，无需承担浏览器或住宅代理的开销。提供 Apify 按事件付费 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/Hangul 公司名称、"The Coca-Cola Company"、L'Oréal）匹配到经过验证的 Google Ads Transparency 法律实体（AR...）。
   • 避免子字符串相似项导致的错误匹配：例如，查询 nike.com 时选中 NIKETA'S COMPANY S.R.L.，而不是 Nike, Inc.（AR16735076323512287233）。并强制执行严格的首词身份门槛，确保不会纳入中间词相似项（Big Apple Pizza LLC）或首词相同但无关的公司（Nike AI Solutions）作为企业子公司。
   • 支持纳入区域子公司（includeSubsidiaries: true，最多包括 3 个经过验证的区域企业实体，例如美国的 Stripe, Inc. + 爱尔兰的 Stripe Payments Europe, Limited）。
2. 分页提取广告创意与素材（SearchCreatives 与 LookupService/GetCreativeById）：
   • 将 ISO-2 countryCode 过滤条件映射到 Google Ads Geo Target Criterion 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 或 30,000 字节的 MCP 响应上限导致页面被截断时，自动回退 pagination.nextPageToken。在下一次 Actor 输入或 MCP 工具调用中，将返回的 pagination.nextPageToken 作为 pageToken 传回，即可继续获取结果，不会重复收费或漏掉广告创意。
3. 零收费架构防护、速率限制安全机制与崩溃安全的 Apify 计费：
   • 将正常的空结果（EMPTY_RESULT）与上游 HTTP 错误（UPSTREAM_ERROR）、速率限制/CAPTCHA 挑战（UPSTREAM_RATE_LIMITED）和 protobuf-JSON 架构变更（SCHEMA_DRIFT_HALT）区分开来，并在产生任何按事件付费账单之前停止运行。
   • 原生集成 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 记录，同时也输出到 stdout；跟踪 inFlightIds、chargedIds、deliveredIds、unknownOutcomeIds 和 stagedItemsById，并通过有界 pushData 重试确保暂时性故障或同一次运行中的恢复续接不会重复收费，也不会丢失已暂存的付费负载。

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