mureo 是一个开源、本地优先的 AI 广告运营控制平面，定位为“AI 广告运营团队”。它让 AI 代理（Claude Code、Cursor、Codex、Gemini 等）通过 mureo 操作 Google Ads、Meta Ads、Amazon Ads、TikTok Ads、Search Console 和 GA4，同时确保每个动作都基于业务策略、关联真实结果，并记录在可回放的审计日志中。凭证始终保留在用户本机。
主要能力
- 策略驱动：每次决策都读取本地 STRATEGY.md（用户画像、独特卖点、品牌语调、目标），让代理围绕业务目标优化，而非仅优化指标。
- 安全门控：包含回滚允许列表、GAQL 输入校验、BYOD 默认只读、凭证守卫、按平台限流等机制。
- 跨平台：在单一工作流中编排 Google Ads、Meta Ads、Amazon Ads、TikTok Ads、Search Console 和 GA4。
- 可审计：仅追加的动作日志支持回滚，并记录每次工具调用及其结果（mureo journal）。
- 本地优先：凭证不离开本机，mureo 本身无遥测。
- 可学习：/learn 会随时间构建账户专属知识库。
使用方式
快速开始（演示）
需要 Python 3.10+ 和 Claude Code（也支持 Cursor、Codex CLI、Gemini CLI）。演示场景使用合成数据，无需广告账户凭证、OAuth 或注册。运行 mureo configure 打开本地浏览器 UI（绑定 127.0.0.1），选择 Claude 应用，一键基础设置，然后在 Demo / BYOD 区域选择演示场景。终端等价命令：mureo setup claude-code --skip-auth && mureo demo init --scenario seasonality-trap。之后在 Claude Code 中打开生成的演示目录并提问，代理会读取演示 STRATEGY.md、拉取广告系列数据，并识别出仅靠数字工具会忽略的季节性陷阱。
路径 A：自带数据（BYOD）
将真实账户数据导出为 XLSX，导入 mureo，获得基于策略的多平台诊断，无需 OAuth 或 API 访问审批。从 mureo configure 仪表板或终端导入。首次运行 /onboard 会通过访谈生成 STRATEGY.md 和 STATE.json。BYOD 在构造上为只读：所有变更工具返回 {"status": "skipped_in_byod_readonly"}，代理只分析和建议，不写入账户。
路径 B：直连（OAuth）
将 mureo 直接连接到 Google Ads / Meta Ads API，以实际执行更改（如 /rescue、/budget-rebalance、/creative-refresh 或通过 rollback_apply 应用回滚），并支持 GA4 / Search Console。在 mureo configure UI 的 Connect platforms 中完成交互式 OAuth。需要 Google Cloud 项目（含 Google Ads API 访问权限和 OAuth 客户端）和/或 Meta App ID + Secret（开发模式即可）。连接后运行一次 /onboard 生成 STRATEGY.md 和 STATE.json。
适用场景
- 广告账户日常健康检查、搜索词清理、竞争扫描、预算再平衡、创意刷新等。
- 跨平台效果关联分析，识别品牌蚕食、转化定义不匹配等问题。
- 需要审计追踪和回滚能力的 AI 驱动广告运营。
- 团队或代理机构可通过商业版（云托管服务或本地 Agency 版）使用，详见 mureo.jp。
限制
- 演示和 BYOD 模式为只读，无法实际执行更改；执行更改需 OAuth 直连。
- OAuth 设置需要 Google Cloud Console 或 Meta for Developers 的配置经验。
- Amazon Ads 通过官方 MCP 桥接，凭证不进入宿主 MCP 配置；TikTok Ads 官方 MCP 已支持。
- 具体收费、价格、平台覆盖的完整列表等未在资料中提供。
安全设计
- 凭证守卫：安装 PreToolUse 钩子，阻止 AI 代理读取 ~/.mureo/credentials.json、.env 等机密文件。
- GAQL 输入校验：所有进入 Google Ads 查询的 ID、日期、字符串字面量都经过白名单校验。
- 异常检测：比较当前指标与基于中位数的基线，发出零花费、CPA 飙升、CTR 下降等告警。
- 回滚允许列表：仅允许列表中的操作可规划回滚，拒绝破坏性动词和意外参数键。
- 不可变数据模型：所有状态对象为 frozen=True 数据类。
- 本地凭证：令牌仅发送至官方广告平台 API。
MCP 工具
mureo 通过 stdio 暴露 229 个 MCP 工具：Google Ads（92）、Meta Ads（90）、Search Console（10），以及回滚、批量、变更导入、异常检测、投放崩溃检测与诊断、排除投放影响预览、跟踪参数一致性、策略/状态上下文、分析注册表、学习、学习期重置预检和 Creative Studio。配置 Amazon Ads 后，桥接的 Amazon 工具会从本地清单添加。任何兼容 MCP 的客户端均可连接。
