OrbiAds 是一个托管的 Google Ad Manager MCP 服务器，为 AI 助手提供对 Google Ad Manager（GAM）的直接自然语言访问。它支持 Claude、ChatGPT、Gemini、Cursor、OpenAI Codex 等平台，覆盖 270 多项操作，涉及广告系列、订单、订单项、创意素材、广告资源、定向和报告，基于当前 GAM API（v202605），并具备 OAuth 授权和写入前确认的安全护栏。
主要能力：
- 广告系列管理：读取实时状态、规划部署、试运行、部署、暂停和回滚。
- 订单与订单项：创建和列出订单、联系人、角色；定义订单项投放规则、CPM 和定向逻辑。
- 创意素材：上传图片、HTML5、视频/音频创意，配置原生样式；管理关联素材；审计点击跟踪器、执行合规扫描、验证 SSL 证书；管理第三方包装器和投放预设。
- 广告资源与定向：获取广告单元树、尺寸，生成 ads.json 清单；创建、更新和列出广告位组；管理自定义定向键/值、国家/地区、类别；检索和修改第一方受众细分。
- 报告与分析：从模板运行自定义报告，检查订单项投放，集成 GA4；运行原始 PQL 数据库查询。
- 交易与公司：管理 PMP 交易、私有拍卖和市场买家；管理代理机构和广告主公司资料。
- 网络与设置：列出可访问网络并切换活动网络上下文；配置默认 CPM、节奏和品牌命名模板；访问租户特定目录。
- 审计与计费：运行自动化安全、卫生和包装器覆盖审计；搜索网络审计日志；获取积分余额和交易历史。
使用方式： OrbiAds 提供两种集成方法：
- MCP 服务器（面向 AI 助手）：将托管 MCP 端点 https://orbiads.com/mcp 添加到 AI 助手配置中。例如 Claude Desktop 在 claude_desktop_config.json 中添加：{ "mcpServers": { "orbiads": { "type": "http", "url": "https://orbiads.com/mcp" } } }；Gemini / AI Studio 通过 Tools → MCP configuration 添加；ChatGPT 通过 Settings → Connectors → Add connector 添加。其他环境（Cursor、Codex、Warp）添加端点并复制 AGENTS.md 到项目根目录。
- CLI（终端与脚本）：轻量级 Python CLI，适用于开发者、CI/CD 管道和无头自动化。安装后需确保 Python 脚本目录加入用户 PATH，否则终端和本地 AI 代理无法找到或执行 orbiads 命令。
此外，还提供 Claude Code 插件（斜杠命令 /adops）和 Agent Skills（结构化工作流），可通过克隆仓库并运行 ./install.sh skills --copy 将技能文件复制到 ~/.claude/skills/ 目录，以应用计划先于变更的工作流。
快速开始：
- 在 orbiads.com 创建免费账户，获得 5 个免费积分，无需信用卡。
- 从仪表板点击 Connect GAM 并使用 Google 账户授权（OAuth，凭据不离开 Google 基础设施）。
- 配置 AI 助手，然后可尝试：“Connect to my GAM account and show me my active networks”。
安全设计： 每个写入操作都需要显式的 ExecutionPlan 预览和确认令牌；所有部署操作支持试运行模式，确认令牌 TTL 为 300 秒；库存提交前有预测门禁；每个操作都有审计跟踪；读取操作始终免费，写入操作透明扣除积分。
适用场景：
- 日常投放广告系列的 AdOps 经理，希望更快且不出错。
- 管理自己 GAM 网络的发布商，希望 AI 辅助工作流。
- 运行多个 GAM 账户的媒体代理机构，希望一致且可审计的流程。
- 在 Claude、ChatGPT 或 Gemini 之上构建 AdOps 自动化的开发者。
限制与说明：
- 仓库内容（分发脚手架、技能、代理、工作流、JSON 模式、CLI 客户端、平台集成清单、文档和示例）以 MIT 许可证发布。
- 托管 MCP 服务器后端及 Cloud Run 服务不在本仓库中，受单独专有条款约束，详见 orbiads.com。
- 读取操作免费，写入和部署操作消耗积分。
- 具体定价、积分消耗率、平台支持细节等未在提供资料中完整说明，请以官方文档为准。
