使用说明
OrbiAds——谷歌广告管理器MCP
Hosted MCP for AI agents, plus a Python CLI for terminal and CI workflows.
Claude、ChatGPT、Gemini和OpenAI Codex的一项技能,使您的AI助手可以直接访问谷歌广告管理器。
3分钟后尝试
托管MCP,无需本地安装
- 在以下网址创建免费OrbiAds帐户 orbiads.com 并连接谷歌广告管理器。
- 将此MCP端点添加到Claude、ChatGPT、Gemini、Cursor、Codex或Warp:
https://orbiads.com/mcp - 问你的经纪人:
Connect to my GAM account and show me my active networks.
CLI烟雾测试
pip install orbiads-cli
orbiads auth login
orbiads network info
信任信号
| 信号 | 状态 | 链接 |
|---|---|---|
| 公共仓库 | OrbiAds MCP发行版的MIT许可镜像 | 许可证 |
| PyPI CLI | 发布为 orbiads-cli 用于终端和CI工作流 |
pypi.org/project/orbiads-cli |
| 托管MCP | 使用OAuth的远程流式HTTP端点 | https://orbiads.com/mcp |
| Glama | 索引MCP注册表页 | glama.ai |
| MCP.so | 索引MCP目录页面 | mcp.so |
| MCP官方注册 | server.json 清单已准备好进行注册表发布 |
server.json |
| Smithery | 为托管/外部MCP上市准备提交目标 | 史密斯·艾/新 |
| 安全模型 | 计划→ 确认→ 执行写操作 | 安全文件 |
两种连接方式
OrbiAds提供了两种集成方法——选择适合您工作流程的方法。
选项A:MCP服务器(AI代理)
通过托管的MCP端点将您的AI助手(Claude、ChatGPT、Gemini)连接到GAM。对话式、引导式、零安装。
MCP endpoint: https://orbiads.com/mcp
选项B:CLI(终端和脚本)
面向开发人员、CI/CD管道和无头自动化的轻量级Python CLI。同样的API,同样的信用,同样的护栏。
pip install orbiads-cli
orbiads auth login
orbiads network info
[!重要] Windows/macOS/Linux PATH警告:如果通过以下方式安装CLI
pip(尤其是与--user),确保将Python脚本目录添加到您的用户PATH如果没有这个,您的终端和本地AI代理(如Claude Code、Cursor或Gemini)将无法找到或执行orbiads命令。请参阅 CLI指南中的故障排除部分 用于快速设置命令。
比较
| 标准 | MCP服务器 | CLI |
|---|---|---|
| 接口 | AI代理(Claude、ChatGPT、Gemini) | 终端/命令行 |
| 安装 | 粘贴到代理设置中的URL | pip install orbiads-cli |
| 身份验证 | 通过浏览器进行OAuth(自动) | OAuth设备流(显示代码) |
| 最适合 | 探索、对话、指导工作流程 | 脚本、CI/CD、无头自动化 |
| 输出格式 | 通过代理的自然语言 | JSON或结构化表 |
| 积分 | 同一消费网格 | 同一消耗网格 |
| 离线 | 否--需要互联网 | 否--要求互联网 |
| 需要Python | 否 | 是(3.10+) |
这两种方法共享相同的后端、信用和安全护栏。
CLI快速参考
| 命令 | 描述 |
|---|---|
orbiads auth login |
通过Google OAuth设备流进行身份验证 |
orbiads auth status |
检查身份验证状态 |
orbiads network info |
显示当前GAM网络详细信息 |
orbiads network list |
列出可访问的GAM网络 |
orbiads orders list |
列出网络中的订单 |
orbiads line-items list --order ID |
列出订单的行项目 |
orbiads creatives list |
列出创意 |
orbiads inventory ad-units |
列出广告单位 |
orbiads forecast check --ad-unit ID |
检查库存可用性 |
orbiads report run --template ID |
运行交付报告 |
完整命令参考: orbiads.com/docs/cli/命令
安装指南
OrbiAds根据您的环境提供三种集成途径。
1.零安装MCP服务器(ChatGPT、Gemini、Claude Desktop)
使用模型上下文协议将您的AI助手连接到我们的托管服务器:
- 克劳德桌面:将此添加到您的
claude_desktop_config.json:{ "mcpServers": { "orbiads": { "type": "http", "url": "https://orbiads.com/mcp" } } } - Gemini/AI工作室:转到工具→ MCP配置→ Add
https://orbiads.com/mcp - ChatGPT:转到设置→ 连接器→ 添加连接器→ MCP网址:
https://orbiads.com/mcp - GLAMA/MCP注册:通过以下方式直接在浏览器中访问、测试和连接服务器 glama.ai/mcp/服务器/OrbiAds/OrbiAds-GAM-mcp
- 其他环境(光标、Codex、扭曲):添加
https://orbiads.com/mcp配置和复制的端点AGENTS.md到你的项目根。
2.克劳德代码插件(Slash命令)
添加 /adops 直接在Claude Code CLI终端中设置命令:
claude plugin install orbiads
3.代理技能(结构化工作流)
将我们基于markdown的指南永久安装到Claude Code的内存中:
- 在本地克隆此存储库。
- 运行技能安装程序:
./install.sh skills --copy
这将我们的6个综合技能文件复制到您的 ~/.claude/skills/ 目录。Claude Code将自动利用它们来防止幻觉,并在更改工作流程之前严格应用该计划。
→ 安装指南: 克劳德 · ChatGPT · 双子座 · OpenAI 代码克斯
OrbiAds是什么?
OrbiAds是一个托管 MCP服务器 它将您的人工智能助手直接连接到谷歌广告管理器(GAM)。您不用点击GAM界面或编写API脚本,而是用简单的语言描述您想要的东西——OrbiAds处理API调用、护栏和审计跟踪。
You: "Check inventory availability on the homepage banner for a 300x250 in France next week"
OrbiAds: [runs forecast] → Available: 1.2M impressions. Pressure: low. Safe to traffic.
You: "Create the line item for Renault, €15 CPM, Monday to Friday"
OrbiAds: [applies guardrails] → Preview ready. Confirm to push?
没有脚本。没有要管理的API令牌。没有切换标签。
这是给谁的?
- 广告运营经理 世卫组织每天都在进行交通活动,希望行动更快,不犯错误
- 出版商 他们管理自己的GAM网络,并希望人工智能辅助的工作流程
- 媒体机构 运行多个想要一致、可审计流程的GAM帐户
- 开发者 在Claude、ChatGPT或Gemini之上构建AdOps自动化
支持的AI平台
| 平台 | 设置指南 | 模式 |
|---|---|---|
| 克劳德 (桌面/claude.ai/克劳德代码) | docs/install/claude.md | 插件+MCP远程 |
| ChatGPT (专业连接器) | docs/install/chatgpt.md | MCP远程(HTTP) |
| 双子座 | docs/install/gemini.md | MCP遥控器 |
| 格拉玛 (MCP注册表) | glama.ai/mcp/服务器/OrbiAds/OrbiAds-GAM-mcp | MCP注册表 |
| 光标/编码/扭曲/其他 | 代理商.md | AGENTS.md+MCP接线 |
所有平台都连接到同一个托管的MCP端点 https://orbiads.com/mcp.
7击杀命令
安装插件后,这些 /adops 命令可以直接在Claude Code中使用。
| 命令 | 它的作用 |
|---|---|
/adops campaign |
读取实时状态、计划部署、模拟运行(ExecutionPlan)、部署、暂停、回滚--带强制计划→确认→执行门 |
/adops audit |
多维账户审计:交付、库存、安全、创意、计费 |
/adops report |
自定义报告、交付查询、CSV导出、账单摘要、预测 |
/adops deal |
PMP交易、私人拍卖、市场PG/PD提案 |
/adops creative |
上传创意、QA合规性、SSL验证、预览URL、行项目关联 |
/adops inventory |
浏览广告单元,管理投放位置和目标分类,运行蓝图 |
/adops admin |
团队、站点、标签、自定义字段、网络设置(仅限MCP表面) |
内部内容(MCP工具和技能)
OrbiAds表面将Google Ad Manager API映射到父工具和数百个操作中,这些操作组织为 6个核心领域代理技能 再加上一个编排器,以保持上下文使用的干净。看 docs/tool-matrix/README.md 用于实时生成的工具和操作计数。
单击下面的任何域,查看包含哪些工具和功能:
1. Campaigns & Creative QA (orbiads-campaigns)
campaign--读取实时活动状态、计划部署、模拟运行、部署、暂停和回滚活动。orders--创建并列出订单、联系人和角色。line_items--定义行项目交付规则、CPM和目标逻辑。creatives--上传创意(图像、HTML5、视频/音频)并配置原生样式。creative_assets--管理关联的图像和文件资产。creative_qa--审核点击跟踪器,执行合规性扫描,并验证SSL证书。creative_wrapper_skill--管理第三方包装和交付预设。formats--发现和配置广告创意格式。jobs&gam_jobs--监控异步活动编译和部署工作流。
2. Inventory & Targeting (orbiads-inventory)
inventory--检索广告单元树、大小,并生成ads.json清单。placements--创建、更新和列出广告投放组。targeting--管理自定义目标键/值、国家和类别。audiences--检索和修改第一方受众细分。blueprint--生成并推送结构化网络库存蓝图。
3. Reporting & Forecasting (orbiads-reporting)
reporting--从模板运行自定义报告,检查行项目交付,并集成GA4。preview--验证库存覆盖率并导出预览URL。pql--运行原始PQL数据库查询。
4. Programmatic Deals (orbiads-deals)
deals--管理PMP交易、私人拍卖和市场买家。companies--管理代理和广告商公司简介。
5. Network Admin (orbiads-admin)
gam_admin--访问高级字段、网络标签、团队和站点记录。gam_features--查询活跃的谷歌广告管理器测试版和系统功能。network--列出可访问的网络并切换活动网络上下文。settings--配置默认CPM、步调和品牌命名模板。tenant_catalog--访问租户特定的目录。
6. Audits & Billing (orbiads-audit)
audit_skill--运行自动安全、卫生和包装覆盖率审计。billing--获取信用余额和交易历史记录。audit--搜索网络审计日志。
看
docs/tool-matrix/README.md查看完整的奇偶校验矩阵,详细说明所有270+个操作的确切成本、写入和参数。
设计安全
每个写入操作都需要一个明确的 ExecutionPlan 预览和确认令牌。没有一场竞选活动是偶然的。
- 变异前的计划 关于活动、交易和产品撰写——预览已签署的
ExecutionPlan在你推之前 - 干运行模式 关于所有部署操作--
confirmationTokenTTL 300秒 - 预报门 在库存提交之前——提前验证可用性
- 审计跟踪 关于每一个行动——谁做了什么,什么时候,结果如何
- 信用保护 --读取操作始终是免费的,写入操作透明地扣除学分
快速入门(3个步骤)
1.创建您的免费帐户
首选 orbiads.com 并注册。有 5个免费学分 --无需信用卡。
2.连接谷歌广告管理器
在OrbiAds仪表板中,单击 连接GAM 并使用您的Google帐户进行授权。OrbiAds使用OAuth——您的GAM凭据永远不会离开谷歌的基础设施。
3.配置您的AI助手
选择您的平台并遵循指南:
然后开始:
“连接到我的GAM帐户并显示我的活动网络”
MCP服务器详细信息
| 财产 | 价值 |
|---|---|
| 端点 | https://orbiads.com/mcp |
| 运输 | streamable-http (默认)· sse |
| Auth | OAuth 2.0——通过OrbiAds访问谷歌帐户 |
| GAM API版本 | v202605 |
| MCP协议 | 2025-03-26 |
仓库结构
skills/ ← orchestrator skill + 6 consolidated dual-surface domain skills (generated)
Each domain skill has SKILL.md (thin) + references/actions.md (full catalogue)
commands/ ← 7 /adops slash commands for Claude Code
agents/ ← Parallel audit subagents (audit-delivery, audit-inventory, …)
hooks/ ← Claude Code hooks (hooks.json)
cli/ ← OrbiAds CLI package (pip install orbiads-cli)
docs/ ← Installation guides, tool matrix, custom-skill authoring guide
_docs/ ← Internal: legacy tool mapping, anti-collision rules
.claude-plugin/ ← Claude plugin manifest (plugin.json, marketplace.json)
AGENTS.md ← Cross-LLM contract for Cursor, Codex, Gemini, Warp, etc.
CLAUDE.md ← Claude Code project guidance
技能和工具矩阵是 生成的 从后端目录中删除——不要手动编辑它们。看
CLAUDE.md对于生成的与手工编写的细分。
定价
| 计划 | 价格 | 积分 |
|---|---|---|
| 试用 | 免费 | 5积分(无卡) |
| 初学者 | 39欧元/月 | 50学分/月 |
| 早期访问 | 29欧元/月 ← 终身锁定 | 50学分/月 |
| S包 | 一次性29欧元 | +50积分 |
| L包 | 一次性45欧元 | +100积分 |
阅读总是免费的。积分仅在写入和部署操作中消耗。
许可证
此存储库的内容——分发框架、技能、代理、工作流、JSON模式、CLI客户端、平台集成清单、文档和示例——在 MIT许可证.
OrbiAds MCP服务器后端和云运行服务,托管端点位于 https://orbiads.com/mcp 连接到的不在此存储库中,并受单独的专有条款管辖-- 请访问orbiads.com查看条款.
