Google AdSense

AdSense MCP

一个 MCP 服务，提供对 AdSense Management API v2 的只读访问：账号、付款、提醒、政策问题、网站、广告资源、广告代码，以及已保存或临时生成的报告。

该服务使用只读 OAuth 范围 https://www.googleapis.com/auth/adsense.readonly。它不会写入 AdSense 账号。

安装

发布后，可通过 MCP 客户端使用 npx -y @sirmacke/adsense-mcp 运行。配置 ADSENSE_ACCESS_TOKEN，或同时配置 ADSENSE_CLIENT_ID、ADSENSE_CLIENT_SECRET 和 ADSENSE_REFRESH_TOKEN。

安全

OAuth 访问令牌、刷新令牌和客户端密钥均为凭据。请勿将其放入此代码库、问题跟踪器、Shell 历史记录或与他人共享的 MCP 配置中。如果凭据泄露，请立即在 Google Cloud 中撤销；请参阅 SECURITY.md。

设置

1. 在 Google Cloud 中启用 AdSense Management API，并创建 OAuth Desktop 客户端。
2. 获取已获准使用 https://www.googleapis.com/auth/adsense.readonly 范围的刷新令牌。请妥善保密。
3. 将 .env.example 复制到安全的环境配置中，并填写 ADSENSE_ACCESS_TOKEN，或填写 OAuth 客户端 ID、密钥和刷新令牌。
4. 安装并构建：

npm install
npm run build

一次性 OAuth 授权（无需 gcloud）

从 Google Cloud 下载 OAuth Desktop 客户端 JSON，然后运行：

$env:ADSENSE_OAUTH_CLIENT_FILE = "C:\secure\adsense-client.json"
$env:ADSENSE_TOKEN_FILE = "C:\secure\adsense-oauth.json"
npm run authorize

该命令会在 localhost 回调中打开 Google 授权页面，并且只将客户端 ID、客户端密钥和刷新令牌保存到私有令牌文件中。将这些值复制到 MCP 配置的 ADSENSE_CLIENT_ID、ADSENSE_CLIENT_SECRET 和 ADSENSE_REFRESH_TOKEN 字段中。请勿让 External 授权页面一直处于 Testing 状态：其刷新令牌会在七天后过期。

Claude Desktop

当前版本的 Claude Desktop 使用扩展。运行 npm run package，然后前往“设置”→“扩展”→“高级设置”→“安装扩展”，安装 build/adsense-mcp.mcpb。系统会安全地提示输入 OAuth 值。若安装版本支持传统配置，请改为添加：

{
  "mcpServers": {
    "adsense": {
      "command": "node",
      "args": ["/absolute/path/to/adsense-mcp/dist/index.js"],
      "env": {
        "ADSENSE_CLIENT_ID": "...",
        "ADSENSE_CLIENT_SECRET": "...",
        "ADSENSE_REFRESH_TOKEN": "..."
      }
    }
  }
}

Codex

在 Codex MCP 配置中添加等效的服务定义，并使用相同的命令、参数和环境变量。该服务使用标准 MCP stdio 传输，可在两个客户端中运行。

工具

账号和账号状态

• adsense_list_accounts
• adsense_get_account
• adsense_list_child_accounts
• adsense_list_payments
• adsense_list_alerts
• adsense_get_ad_blocking_recovery_tag
• adsense_list_policy_issues
• adsense_get_policy_issue
• adsense_list_sites
• adsense_get_site

广告资源

• adsense_list_ad_clients
• adsense_get_ad_client
• adsense_get_ad_client_ad_code
• adsense_list_ad_units
• adsense_get_ad_unit
• adsense_get_ad_unit_ad_code
• adsense_list_linked_custom_channels
• adsense_list_url_channels
• adsense_get_url_channel
• adsense_list_custom_channels
• adsense_get_custom_channel
• adsense_list_linked_ad_units

报告

• adsense_list_saved_reports
• adsense_get_saved_report
• adsense_generate_saved_report
• adsense_generate_report

如果未提供 account，账户级工具会查找已配置的账户或首个可访问的账户。分页列表工具接受 pageSize 和 pageToken；传入返回的 nextPageToken 即可继续。特定资源的工具接受相应列表工具返回的规范名称。

adsense_list_payments 会返回已支付和未支付的收入，包括格式化金额；对于已支付的收入，还会返回入账日期。AdSense API 不会公开银行或付款方式的详细信息。

报告请求示例：metrics: ["ESTIMATED_EARNINGS", "PAGE_VIEWS", "CLICKS"]、dimensions: ["DATE", "COUNTRY_NAME"]、dateRange: "LAST_7_DAYS"、orderBy: ["-ESTIMATED_EARNINGS"]。

服务会返回结构化 JSON。由于 Agent 可以在需要 CSV 时将结构化响应转换为 CSV，因此特意省略了 API 中重复的 CSV 报告方法。

验证

npm test
npm run build

在线验证还需要上述 OAuth 值和一个 AdSense 账户。所有公开的端点均接受 AdSense 只读 OAuth 作用域。

发布

发布版本会同时发布到 npm 和官方 MCP Registry。注册表会存储来自 server.json 的发现元数据；可安装的服务本身则通过 npm 分发。

1. 在 package.json、package-lock.json、server.json（包括其中的 npm 包条目）、mcpb/manifest.json 以及 src/index.ts 中的 MCP 服务版本中，统一更新版本号。
2. 运行 npm test 和 npm pack --dry-run，验证构建结果和发布包的内容。
3. 将发布提交提交并推送到 GitHub。
4. 使用 npm publish --access public 发布公开的 scoped package。
5. 如有必要，使用 mcp-publisher login github 完成身份验证，然后运行 mcp-publisher publish，发布版本匹配的 server.json。

请先发布到 npm，再发布到 MCP Registry，因为注册表验证要求引用的公开包版本已存在。已发布的版本不可修改，因此如需更正，必须发布新版本。

许可证

MIT