Reddit Ads MCP 连接器

面向 Reddit Ads API v3 的通俗语言 MCP
API 基础地址：https://ads-api.reddit.com/api/v3

用简单英语提问即可 — 无需记住端点路径或广告账户 ID（当只配置了一个账户时）。

它能做什么

Related MCP server: Google Ads API v20 MCP Server

前提条件

1. 在 reddit.com/prefs/apps 创建一个 Reddit 应用 — 类型选择 web app 或 script

2. 记下 client ID（位于应用名称下方）和 client secret

3. 一个具有 adsread 权限范围的 refresh token（一次性 OAuth — 见下文）

设置（本地）

cd reddit-mcp-connector
python -m venv .venv
# Windows:
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

填写 .env：

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_secret
REDDIT_REFRESH_TOKEN=your_refresh_token
REDDIT_USER_AGENT=web:reddit-mcp-connector:v1.0.0 (by /u/YOUR_USERNAME)
REDDIT_AD_ACCOUNT_ID=t2_xxxxx   # optional but recommended

启动服务器：

python reddit_mcp_server.py --http

监听地址为 http://127.0.0.1:8002/mcp。

获取 refresh token（一次性操作）

1. 构建一个授权 URL（替换占位符）：

https://www.reddit.com/api/v1/authorize?client_id=YOUR_CLIENT_ID&response_type=code&state=anything&redirect_uri=http://localhost:8080&duration=permanent&scope=adsread

2. 在浏览器中打开它，批准访问，从重定向 URL 中复制 code。

3. 交换该 code：

curl -X POST https://www.reddit.com/api/v1/access_token ^
  -u "CLIENT_ID:CLIENT_SECRET" ^
  -d "grant_type=authorization_code&code=CODE&redirect_uri=http://localhost:8080"

4. 将 JSON 响应中的 refresh_token 保存到 .env 中，作为 REDDIT_REFRESH_TOKEN。

Reddit 应用设置中的重定向 URI 必须完全匹配（例如 http://localhost:8080）。

Cursor（本地）

"reddit": {
  "url": "http://127.0.0.1:8002/mcp"
}

1. 保持服务器运行：python reddit_mcp_server.py --http

2. Cursor 设置 → MCP → 刷新

3. reddit 应显示为绿色，并带有 list_campaigns、get_performance_report 等工具

然后提问：“列出我的广告系列”或“最近 7 天的花费和展示次数”。

Google Cloud Run

在 Cloud Run 上托管同一个 HTTP MCP 端点。

部署

.\deploy-cloudrun.ps1 -ProjectId "YOUR_GCP_PROJECT_ID"

凭据以 JSON 格式存储在 Secret Manager 中（reddit-mcp-credentials）。脚本会提示输入缺失的值，或从 .env 中读取。

Cursor（Cloud Run）

"reddit": {
  "url": "https://YOUR-CLOUD-RUN-URL/mcp"
}

Claude 自定义连接器

当设置了 MCP_PUBLIC_URL 时（部署脚本会自动设置），Claude.ai OAuth + DCR 即被启用。

1. 使用 .\deploy-cloudrun.ps1 -ProjectId "..." 部署

2. 设置 → 连接器 → 添加自定义连接器

3. URL：https://YOUR-SERVICE.run.app/mcp（必须包含 /mcp）

4. 将 OAuth Client ID 留空（已启用 DCR）

示例提示

• “列出我的 Reddit 广告账户”

• “显示我的广告账户的广告系列”

• “最近 7 天的花费和展示次数”

• “本月每日效果趋势”

• “按广告系列细分效果”

• “列出转化像素”

工具

安全说明

Cloud Run 部署使用 --allow-unauthenticated，因此 MCP URL 可被访问。Claude OAuth 将工具访问限制为已注册的客户端。请将凭据和 URL 视为敏感信息。