mcp-server-reddit-ads 是一个面向 Reddit Ads API v3 的 MCP 服务器，由实际投放 Reddit 广告的开发者构建并自用验证。它为 MCP 客户端提供对 Reddit 广告账户的读取与写入能力，并通过分级安全控制限制可能产生支出的操作。
用途与主要能力 该服务器为 MCP 客户端提供对广告活动、广告组、广告及效果报告的读取访问，同时提供受控制的写入工具，用于暂停、创建、修改预算与出价、编辑定向，以及在广告组之间复制广告。读取侧暴露 18 个工具；写入侧按层级逐步解锁。
使用方式 使用前提包括：一个具备业务管理员权限的 Reddit 广告账号（用于注册应用）、Node.js 20 或更高版本，以及任一 MCP 客户端（Claude Code、Claude Desktop 或其他）。安装路径分为三类：针对 Claude Code 的“粘贴一条提示”方式（推荐，由客户端读取 README、运行 npx mcp-server-reddit-ads auth、写入 .mcp.json 并确认服务器加载）；针对 Claude Desktop 的引导式提示（由客户端充当向导，用户自行运行一条命令并编辑一个配置文件）；以及适用于其他客户端或偏好手动操作的高级手动流程，约需五分钟。 手动流程要点：在 ads.reddit.com 登录具备业务管理员权限的账号；进入 Business settings 中的 Developer Applications 创建应用，名称自定，重定向 URI 必须精确为 http://localhost:8080，并选择一位业务管理员作为主要联系人；保存后获取 Client ID（约 22 字符的短字符串，常显示在应用名称下方且无明确标签）与 Client secret（在明确标注 secret 的字段中，需立即复制，丢失可重新生成）。注意不要使用 reddit.com/prefs/apps，该入口会依据 Responsible Builder Policy 静默拒绝新应用。随后运行内置安装助手，输入或通过 REDDIT_CLIENT_ID 与 REDDIT_CLIENT_SECRET 提供凭据，浏览器打开 Reddit 授权页面并在 http://localhost:8080 等待批准；批准后可将凭据直接写入磁盘（会备份已有文件为 <file>.bak 且不影响其他服务器），也可选择打印可粘贴的配置块。若失败，常见原因有两个：8080 端口被占用，或重定向 URI 不匹配。配置完成后重启客户端，确认服务器加载，并请求列出 Reddit 广告账户，应能看到账户 id（形如 a2_...）。若只管理一个账户，可在配置中设置 REDDIT_ADS_ACCOUNT_ID 并重启，从而无需在每次请求中指定账户。连接后默认为只读，适合日常查看，例如账户概览、按广告活动的近 7 天表现、当前活跃的广告组。
写入与安全层级 全新安装无法暂停、创建或编辑任何内容。要允许更改，需提升配置中的 REDDIT_ADS_WRITE_TIER 并重启。建议先设为 safe（该层级不会启动或增加支出），只有确实打算恢复投放或更改预算、出价、定向时，再升至 spend。高于当前层级的工具不仅会被拒绝，还会从客户端的工具列表中完全隐藏；即使被意外调用，服务器也会以指明所需层级的错误拒绝。
环境变量与工具细节 REDDIT_ADS_WRITE_TIER 控制写入层级，默认关闭写入，分两步打开。get_campaigns、get_ad_groups 与 get_ads 支持可选的状态过滤（ACTIVE、PAUSED、ARCHIVED），在客户端侧对 configured_status 应用。工具结果上限为 200,000 字符，被截断时会提示并建议缩小查询范围。get_performance_report 接受友好的小写指标名（如 impressions、clicks、spend、cpc、conversion_page_visit_clicks 等），并在调用前本地校验，拼写错误时提示最接近的匹配。create_ad_group 需要 conversion_pixel_id，当启用广告活动预算优化时 create_campaign 也需要该参数（Reddit 自 2026-07-13 起的要求）；像素 id 可在 Reddit Ads 仪表板的 Events Manager 中找到，在观察数据中它等于广告账户 id。copy_ads 可将广告复制到另一广告组（每次复制 Reddit 会创建一条重复的推广帖），并可选重写 utm_campaign 等点击 URL 查询参数。广告文案（标题、正文）通过 Reddit API 不可修改，唯一可编辑的帖子属性是 allow_comments；要更改广告内容，需以新文案创建新广告、启用它并暂停旧广告。
Reddit API 注意事项 更新使用 PATCH 而非 PUT，且 Reddit 对错误动词返回 404 而非 405，动词错误看起来与资源缺失完全相同，这是上游包中破坏所有写入的 bug。单个资源位于裸路径（/ads/{id}），集合与创建使用账户作用域路径（/ad_accounts/{id}/ads），混用会返回 404。所有金额字段为微货币（货币单位的百万分之一），该服务器在读取时转换为美元、写入时转换回去，因此工具输入输出均为美元。报告指标名在请求中为大写枚举，在响应中为小写且拼写不一致（例如 CONVERSION_SIGN_UP_CLICKS 与 CONVERSION_SIGNUP_TOTAL_VALUE），建议使用友好小写名称，由服务器校验并映射。写入后应信任 configured_status 而非 effective_status，前者立即更新，后者可能滞后数分钟。
限制与免责 该软件按“原样”和“可用”状态提供，不附带任何保证，可能包含错误，其安全控制可能失效或表现异常，使用风险自负。该工具可以创建、重命名、暂停、恢复和重新配置真实的 Reddit 广告实体，并可更改预算、出价和定向，这些操作可能启动、增加或以其他方式影响真实广告支出。用户需自行承担由此产生的费用、支出或财务结果，独立审查并核实其做出的每项变更，妥善保管 Reddit API 凭据，并确保对 Reddit Ads API 的使用符合 Reddit 条款。作者不对丢失或意外的广告支出、错误配置或暂停的广告活动、意外更改或其他损害承担责任，包括其安全控制未能阻止某项操作的情况。该项目为独立的非官方客户端，与 Reddit, Inc. 无隶属、背书或赞助关系。
适用场景 适合需要以自然语言方式管理 Reddit 广告账户的广告主与营销人员，用于日常读取账户概览与效果报告，以及在受控层级下进行预算、出价、定向调整和新广告创建等操作。需注意该工具只面向 Reddit Ads API，不涉及其他广告平台，且写入能力需要明确开启。
