mcp-google-ads-transparency-monitor

Google Ads Transparency Monitor MCP Server

这是一个 MCP 服务，适用于 Apify 上 Mamba Labs 的 Google Ads Transparency Monitor actor。提供公司域名或广告主名称即可。每次运行都会读取 Google 公开的 Ads Transparency Center，并为每条广告返回一行，包含广告格式、首次和最后展示日期、创意链接及广告页面；此外还会返回一条公司摘要行，其中包含 Google 给出的广告总数区间。

内容

• 功能
• 快速开始
• 前提条件
• 示例提示词
• 工具
• 输入
• 定价
• 你的密钥
• 完整 actor 文档
• 许可证

功能

列出公司投放的 Google 广告。提供公司域名（例如 stripe.com）或广告主名称，也可以提供多个域名或名称。每条广告会返回一行，包含广告主、广告 ID、格式（文本、图片或视频）、首次和最后展示日期、创意链接，以及广告在 Transparency Center 中的页面；此外，每项输入还会有一条摘要行，说明该公司是否投放 Google 广告、广告数量（Google 给出的数量区间，例如 8,000 到 9,000）以及广告格式。没有广告、请求被阻止或 Google 页面发生变化时，也会免费返回相应行，并通过 row_status 说明原因。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 actor 运行、等待运行结束，并返回数据集中的行。

快速开始

你需要 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。一个工具。示例参数：

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

输入

实时 Actor 的所有买家可见输入，保持不变。省略的输入将采用 Actor 自身的默认值。请提供 company_domain、advertiser_name、domains 或 advertiser_names 之一。

输入	类型	必填	描述
company_domain	string	否	公司网站域名，例如 stripe.com。
advertiser_name	string	否	Google 验证的广告主名称，例如 Stripe, Inc.
domains	array	否	多个公司域名。每次运行最多输入 500 个。
advertiser_names	array	否	多个广告主名称。
region	string	否	anywhere，或两位国家/地区代码，例如 US、GB、DE 或 FR。默认值为 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

没有广告的行、被拦截的行、来源已更改的行、错误行和缓存行均免费。

你的密钥

此 Actor 无需服务提供商密钥。它读取 Google Ads Transparency Center 的公开数据，且自身不持有任何密钥。如果运行使用 Apify 代理流量，不会增加你的费用：Mamba Labs 承担本次运行的平台成本。proxy_mode 是可靠性设置。

Actor 完整文档

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

许可证

MIT。请参阅 LICENSE。