Reddit Ads MCP

RedditAdsMcp

用于 Reddit Ads API 的 C# MCP（模型上下文协议）服务。提供只读工具，可列出账户、广告系列、广告组和广告，并获取效果报告。

使用 .NET 10 和官方 ModelContextProtocol SDK 构建。

可用工具

工具	描述
ListAccounts	列出当前凭据可访问的所有 Reddit 广告账户
ListCampaigns	列出某个账户的广告系列
ListAdGroups	列出广告组，可按广告系列筛选
ListAds	列出广告，可按广告组筛选
GetPerformanceReport	获取效果报告，可自定义日期范围、字段和细分项
GetDailyPerformance	便捷封装 — 获取最近 N 天的展示次数、点击次数、花费、CTR、CPC、eCPM

所有工具都接受可选的 accountId 参数。如果省略，则使用 REDDIT_ACCOUNT_ID 中的默认账户。

前置条件

1. 一个拥有有效 Reddit Ads 广告主账户的 Reddit 账户
2. .NET 10 SDK

安装

选项 A：安装为 dotnet 工具（推荐）

dotnet tool install -g RedditAdsMcp

然后配置 Claude Code（请参阅下文的步骤 5b）。

选项 B：克隆并从源代码构建

git clone https://github.com/mkerchenski/RedditAdsMcp.git
cd RedditAdsMcp
dotnet build

然后配置 Claude Code（请参阅下文的步骤 5a）。

设置

1. 创建 Reddit Ads API 应用

1. 前往 ads.reddit.com
2. 在左侧边栏中，点击 Developer Applications（位于账户/企业设置下）
3. 点击 Create a new app 并填写：

字段	值
App name	Reddit Ads MCP
Description	MCP server for Reddit Ads reporting
About url	https://github.com/mkerchenski/RedditAdsMcp（或留空）
Redirect URI	https://hurrah.dev/oauth/reddit

Reddit 要求使用公开的 HTTPS 重定向 URI（localhost 无法使用）。上方的 URL 是由软件包作者维护的简单回调页面，会显示授权码供你复制，不会存储任何数据。你也可以使用自己控制的任何 HTTPS URL；只需在步骤 2–3 中将重定向 URI 更新为相应 URL。

4. 点击 Create app
5. 复制 App ID 和 Secret，后续步骤中会用到

2. 授权应用

在浏览器中打开以下 URL，将 YOUR_APP_ID 替换为步骤 1 中的 App ID：

https://www.reddit.com/api/v1/authorize?client_id=YOUR_APP_ID&response_type=code&state=mcp&redirect_uri=https%3A%2F%2Fhurrah.dev%2Foauth%2Freddit&duration=permanent&scope=adsread

点击 Allow。你将被重定向到一个显示授权码的页面，点击 Copy。

3. 将授权码换取刷新令牌

运行此命令，将三个占位符替换为你的 App ID、Secret 和授权码：

curl -X POST https://www.reddit.com/api/v1/access_token \
  -u "YOUR_APP_ID:YOUR_SECRET" \
  -A "ads-mcp/1.0" \
  -d "grant_type=authorization_code&code=YOUR_AUTHORIZATION_CODE&redirect_uri=https://hurrah.dev/oauth/reddit"

redirect_uri 必须与步骤 1 中填写的内容完全一致。

响应 JSON 中包含 refresh_token 字段。请保存好它，除非撤销，否则它会永久有效。

4. 查找账户 ID

1. 前往 ads.reddit.com，点击 All accounts（左上角下拉菜单）
2. 在左侧选择你的企业，右侧会显示你的广告账户
3. 账户 ID 是账户名称下方的值（例如 a2_eaf73mplhhps）

5a. 配置 Claude Code（从源代码构建）

将以下内容添加到 Claude Code MCP 设置中（项目中的 .mcp.json 或 ~/.claude/settings.json），并替换四个占位值：

"reddit-ads": {
  "type": "stdio",
  "command": "dotnet",
  "args": ["run", "--project", "/path/to/RedditAdsMcp", "--no-build"],
  "env": {
    "REDDIT_CLIENT_ID": "your_app_id",
    "REDDIT_CLIENT_SECRET": "your_secret",
    "REDDIT_REFRESH_TOKEN": "your_refresh_token",
    "REDDIT_ACCOUNT_ID": "your_account_id"
  }
}

5b. 配置 Claude Code（dotnet 工具）

"reddit-ads": {
  "type": "stdio",
  "command": "reddit-ads-mcp",
  "env": {
    "REDDIT_CLIENT_ID": "your_app_id",
    "REDDIT_CLIENT_SECRET": "your_secret",
    "REDDIT_REFRESH_TOKEN": "your_refresh_token",
    "REDDIT_ACCOUNT_ID": "your_account_id"
  }
}

在 Claude Code 中使用 /mcp 验证，reddit-ads 服务应显示 6 个工具。

开发

dotnet build    # compile
dotnet run      # start MCP server on stdio
dotnet pack     # create NuGet package

许可证

MIT