Adsense MCP Server

AdSense MCP服务器

Google AdSense MCP服务器——将Google AdSense连接到Claude、Cursor和其他MCP客户端。

](https://www.npmjs.com/package/@appsyogi/adsense-mcp-server) ](https://www.npmjs.com/package/@appsyogi/adsense-mcp-server)  

特性

• 📊 收益摘要 --快速概述今天、昨天、过去7天和每月收入
• 📈 详细报告 --生成包含维度（日期、地点、国家、广告单位）和指标的报告
• 🔄 期间比较 --比较时间段之间的性能
• 🌐 站点状态 --检查所有网站的审批状态
• ⚠️ 警报和政策问题 --监控账户健康状况，及早发现违规行为
• 💰 付款历史记录 --查看付款历史记录和待处理收益
• 📦 广告单位 --列出广告单元并获取嵌入代码
• 📤 CSV导出 --导出报告以供进一步分析
• 💾 缓存 --SQLite缓存可实现更快的重复查询
• 🔐 安全 --OAuth令牌存储在操作系统密钥链中，只读范围

快速开始

# Install globally
npm install -g @appsyogi/adsense-mcp-server

# Set up OAuth credentials
adsense-mcp init

# Verify setup
adsense-mcp doctor

# Start the server (for MCP clients)
adsense-mcp run

先决条件

1.创建Google Cloud OAuth凭据

您需要在Google Cloud Console中创建自己的OAuth凭据：

1. 首选 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用 AdSense管理API:

- 转到“API和服务”→ “图书馆” - 搜索“AdSense Management API” - 点击“启用”

1. 创建OAuth凭据：

- 转到“API和服务”→ “凭据” - 点击“创建凭据”→ “OAuth客户端ID” - 选择“桌面应用程序” - 命名它（例如，“AdSense MCP”） - 点击“创建”

1. 复制 客户端ID 和 客户端密钥
2. 添加测试用户（应用程序处于测试模式时需要）：

- 转到“API和服务”→ “OAuth同意屏幕” - 滚动到“测试用户”部分 - 点击“添加用户” - 添加您将用于身份验证的Google帐户电子邮件 - 点击“保存”

注： 虽然您的应用程序的发布状态为“测试”，但只有测试用户可以进行身份验证。您最多可以添加100个测试用户。

2.配置AdSense MCP

运行init命令并输入您的凭据：

adsense-mcp init

这将：

• 提示输入您的客户端ID和客户端密码
• 打开浏览器进行谷歌身份验证
• 将刷新令牌安全地存储在操作系统密钥链中

安装

npx @appsyogi/adsense-mcp-server init

快速开始

1.初始化（OAuth设置）

npx adsense-mcp init

这将：

• 打开浏览器进行谷歌登录
• 请求以只读方式访问您的AdSense数据
• 让您选择默认帐户（如果您有多个）
• 安全地存储凭据

2.验证设置

npx adsense-mcp doctor

3.添加到您的MCP客户端

VS代码副本(~/.vscode/mcp.json)

{
    "servers": {
        "adsense": {
            "command": "npx",
            "args": ["@appsyogi/adsense-mcp-server", "run"],
            "type": "stdio"
        }
    }
}

克劳德桌面(~/Library/Application Support/Claude/claude_desktop_config.json)

{
    "mcpServers": {
        "adsense": {
            "command": "npx",
            "args": ["@appsyogi/adsense-mcp-server", "run"]
        }
    }
}

可用工具

对话示例

查看收益

You: How's my AdSense doing today?

Claude: 📊 **AdSense Earnings Summary**

| Period | Earnings | Impressions | Clicks | CTR |
|--------|----------|-------------|--------|-----|
| Today | $8.45 | 3,200 | 28 | 0.88% |
| Yesterday | $15.67 | 6,200 | 52 | 0.84% |
| Last 7 Days | $98.45 | 42,000 | 380 | 0.90% |
| This Month | $345.67 | 150,000 | 1,350 | 0.90% |

You're tracking 16% ahead of last month at this point! 🎉

检查站点状态

You: Is my new site approved yet?

Claude: 📋 **Site Status**

| Site | Status | Notes |
|------|--------|-------|
| example.com | ✅ READY | Ads serving |
| blog.example.com | ⏳ GETTING_READY | Under review |
| newsite.com | ⚠️ NEEDS_ATTENTION | Insufficient content |

生成报告

You: Show me earnings by country for last week

Claude: [Generates report with COUNTRY_NAME dimension]

CLI命令

adsense-mcp init

设置OAuth身份验证并选择默认帐户。

# Interactive setup
npx adsense-mcp init

# Set specific default account
npx adsense-mcp init --account pub-1234567890123456

# Use service account (advanced)
npx adsense-mcp init --service-account /path/to/key.json

adsense-mcp doctor

验证您的设置并检查帐户运行状况。

npx adsense-mcp doctor

adsense-mcp run

启动MCP服务器（通常由您的MCP客户端调用）。

# Use default account
npx adsense-mcp run

# Use specific account
npx adsense-mcp run --account pub-9876543210987654

# Verbose logging
npx adsense-mcp run --verbose

多账户支持

如果您有多个AdSense帐户，您可以：

1. 选择默认值 init
2. 覆盖 --account 旗帜
3. 使用 adsense_list_accounts 查看所有帐户的工具
4. 通过 accountId 任何工具的参数

数据存储

所有数据都存储在本地 ~/.config/adsense-mcp/:

• config.json -默认帐户和设置
• tokens.json -OAuth刷新令牌（加密）
• cache.sqlite -报告缓存以实现更快的响应

安全

• 只读访问 -此服务器仅请求 adsense.readonly 范围
• 安全令牌存储 -令牌使用操作系统密钥链加密（通过keytar）
• 仅限本地 -所有数据都保留在您的机器上
• 无遥测 -我们不收集任何使用数据

速率限制

AdSense API有严格的速率限制（每分钟100个请求）。此服务器：

• 智能缓存响应（基于数据类型，5分钟-24小时）
• 对重试实施指数回退
• 跟踪请求率以避免达到限制

故障排除

“未找到令牌”错误

跑 npx adsense-mcp init 设置身份验证。

“超出速率限制”错误

请稍候，然后重试。服务器将自动重试并回退。

“找不到帐户”错误

请确保在安装过程中选择了有效的帐户。跑 npx adsense-mcp doctor 查看可用帐户。

发展

# Clone the repo
git clone https://github.com/AppsYogi-com/adsense-mcp-server.git
cd adsense-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in dev mode
npm run dev

# Test locally
node dist/cli/index.js doctor

许可证

麻省理工学院

贡献

欢迎投稿！请打开问题或PR。

学分

内置：

• @模型上下文协议/sdk
• 谷歌蜜蜂
• 指挥官
• 更好平方3
• 买家