广告管理AI连接器

OrbiAds是一个托管MCP服务器,通过AI助手直接连接Google Ad Manager,实现广告运营自动化。

  • by OrbiAds
  • Python
  • 混合部署
  • 3 星标
  • 更新于
在 GitHub 查看 OrbiAds/Orbiads-GAM-MCP

使用说明

OrbiAds——谷歌广告管理器MCP

英语 · 法语


Hosted MCP for AI agents, plus a Python CLI for terminal and CI workflows.

Claude、ChatGPT、Gemini和OpenAI Codex的一项技能,使您的AI助手可以直接访问谷歌广告管理器。

→ 在orbiads.com免费开始 · ★ 标记此回购


3分钟后尝试

托管MCP,无需本地安装

  1. 在以下网址创建免费OrbiAds帐户 orbiads.com 并连接谷歌广告管理器。
  2. 将此MCP端点添加到Claude、ChatGPT、Gemini、Cursor、Codex或Warp:
    https://orbiads.com/mcp
    
  3. 问你的经纪人:
    Connect to my GAM account and show me my active networks.
    

CLI烟雾测试

pip install orbiads-cli
orbiads auth login
orbiads network info

想要更深入的设置路径吗?从 CLI指南 或 代理安装指南.


信任信号

信号 状态 链接
公共仓库 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的内存中:

  1. 在本地克隆此存储库。
  2. 运行技能安装程序:
    ./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 在你推之前
  • 干运行模式 关于所有部署操作-- confirmationToken TTL 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查看条款.