RedditAdsMcp 的
 
用于Reddit Ads API的C#MCP（模型上下文协议）服务器。提供只读工具，用于列出帐户、活动、广告组、广告和提取绩效报告。
用。NET 10和官方 模型上下文协议 SDK。
可用工具
| 工具 | 说明 |
|---|---|
ListAccounts | 列出所有可使用当前凭据访问的Reddit广告帐户 |
ListCampaigns | 列出帐户的活动 |
ListAdGroups | 列出广告组，可选择按活动筛选 |
ListAds | 列出广告，可选择按广告组筛选 |
GetPerformanceReport | 获取包含自定义日期范围、字段和细分的绩效报告 |
GetDailyPerformance | 便利包装——最近N天的展示次数、点击次数、花费、点击率、CPC、eCPM |
所有工具都接受可选 accountId 参数。如果省略，则默认帐户来自 REDDIT_ACCOUNT_ID 使用。
先决条件
- 一个活跃的Reddit帐户 Reddit广告 广告商帐户
- .NET 10 SDK
安装
选项A：作为.NET工具安装（推荐）
dotnet tool install -g RedditAdsMcp然后配置Claude代码（请参阅 步骤5b 在......下面
选项B：从源代码克隆和构建
git clone https://github.com/mkerchenski/RedditAdsMcp.git
cd RedditAdsMcp
dotnet build然后配置Claude代码（请参阅 步骤5a 在......下面
设置
1.创建Reddit Ads API应用程序
- 首选 ads.redit.com
- 在左侧边栏中，单击 开发人员应用程序 （在您的帐户/业务设置下）
- 点击 创建新应用程序 并填写：
| 字段 | 值 |
|---|---|
| 应用程序名称 | Reddit Ads MCP |
| 描述 | MCP server for Reddit Ads reporting |
| 关于url | https://github.com/mkerchenski/RedditAdsMcp （或留空） |
| 重定向URI | https://hurrah.dev/oauth/reddit |
Reddit需要一个公共HTTPS重定向URI（localhost不起作用）。上面的URL是由包作者维护的一个简单的回调页面，它显示了供您复制的授权码，但不存储任何数据。您可以使用您控制的任何HTTPS URL；只需更新步骤2-3中的重定向URI即可。
- 点击 创建应用程序
- 复制您的 应用ID 和 秘密 --在接下来的步骤中，你需要两者
2.授权应用程序
在浏览器中打开此URL，替换 YOUR_APP_ID 使用步骤1中的应用程序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点击 允许。您将被重定向到显示您的授权码的页面--单击 复制.
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
- 首选 ads.redit.com 然后单击 所有账户 （左上角下拉菜单）
- 在左侧选择您的企业——您的广告账户出现在右侧
- 帐户ID是帐户名称下的值（例如。
a2_eaf73mplhhps)
5a。配置Claude代码（从源代码）
添加到您的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。配置克劳德代码（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"
}
}证实 /mcp 在克劳德法典中 reddit-ads 服务器应配备6个工具。
发展
dotnet build # compile
dotnet run # start MCP server on stdio
dotnet pack # create NuGet package许可证
麻省理工学院