Adako: ad ops for AI assistants

Adako：面向 AI 助手的广告运营

アダコ · adako.ai

Adako 是一个 MCP 服务和 REST API，可将 Claude、ChatGPT、Cursor 及其他助手连接到 Google Ads、Meta Ads、ChatGPT Ads、TikTok Ads 和 LinkedIn Ads。

https://adako.ai/mcp

询问“我的广告系列上个月表现如何？”，即可获取来自实时账户、以账户自身货币显示的答案。询问“把那个预算提高到每天 40”，即可获得一份提案，由你批准后才会执行任何更改。新建的广告系列始终处于暂停状态。

本仓库包含公开部分：Agent Skills、各客户端的配置、单文件安装程序、Claude Code 插件，以及 MCP Registry 条目。服务本身托管在云端。

---

功能

涵盖五个平台的 233 个工具，以及 Adako 自有工具。

平台	工具数	涵盖内容
Google Ads	70	搜索和 Performance Max、关键词和搜索字词、预算和出价策略、素材和扩展、转化操作、标签、排期、地理位置、分时段和设备报告
Meta Ads	44	广告系列、广告组和广告、图片、视频、轮播和应用安装推广、受众和版位、像素、潜在客户表单、创意疲劳
LinkedIn Ads	34	广告系列组和广告系列、图片、视频、轮播和文本广告、B2B 定向、受众预测、转化规则、互动指标
TikTok Ads	30	广告系列、广告组和信息流视频广告、Spark Ads、视频指标、身份、像素、创意疲劳
ChatGPT Ads	23	端到端的聊天卡片广告系列、账户限制、像素、审核结果
Adako	32	连接和用量、工具发现、提案、诊断、监控、简报和报告

客户端不会看到 233 个条目，而是会看到可按名称调用的 16 个工具，以及 13 个路由器。每个平台都有一个读取路由器（google_ads、meta_ads、chatgpt_ads、tiktok_ads、linkedin_ads） 和一个对应的写入路由器（google_ads_write、meta_ads_write、chatgpt_ads_write、 tiktok_ads_write、linkedin_ads_write）。监控有 monitoring 和 monitoring_write，而 diagnostics 仅用于读取。读取调用示例如下： google_ads(action="execute", tool_name="google_list_campaigns", arguments={...})；更改调用示例如下：google_ads_write(action="execute", tool_name="google_pause_campaign", arguments={...})。

查询信息不会更改账户，因此，对于每次调用工具都要求授权的助手，只需允许一次读取操作即可。每项更改都通过 _write 工具执行，每次都会请求授权并创建提案。search_tools 可根据你自己的措辞找到合适的工具，并返回其准确的调用语句，而且免费。请参阅 adako.ai/docs/routers。

所有人都可以读取 LinkedIn Ads 数据：连接广告账户管理员的成员后，即可使用所有报告、结构和预测工具。如需进行更改，必须先将该广告账户添加到 Adako 的 LinkedIn 应用中——请将九位数 ID 发送至 [email protected]。TikTok Ads 工具已提供，但在 TikTok 批准 Adako 的开发者应用之前，无法连接 TikTok 账户。

---

安全模型

Adako 的设计目标是让助手既实用，又不会带来危险。

规则	含义
读取操作立即执行	性能、结构、搜索词、受众。无需审批。
每次写入都会变成提案	在发送任何内容之前，你都可以查看对象、变更前后的值以及每日费用。
由你决定是否批准	在聊天中确认，或将提案留在收件箱中，并前往 adako.ai/approvals 批准。提案将在 48 小时后过期。
创建的对象均为暂停状态	Adako 创建的每个广告系列、广告组和广告都会以暂停状态启动。是否启用由你决定。
几乎不会删除任何内容	有 8 个工具可以移除内容，每个都需要显式的确认标志。暂停操作绝不会转为删除操作。
每项操作只执行一次	每个获批提案都带有一个幂等键。重复批准时会返回首次操作的结果，不会重复执行。
每次写入后都会回读确认	通过从平台回读对象来确认变更，而不是依赖响应内容。
令牌保留在服务端	你的平台令牌由 Adako 加密保存，绝不会转发给 AI 客户端。

详情：adako.ai/docs/safety。

---

安装 — 五分钟

有两种身份验证方式：

• OAuth — 客户端会打开浏览器，你只需登录 Adako 一次。适用时优先使用此方式。
• API 密钥 — 在 adako.ai/keys 创建密钥，并将其作为 Authorization: Bearer ak_live_your_key 发送，其中 ak_live_your_key 要替换为你复制的完整密钥， 包含前缀，且不要添加其他内容。适用于读取静态配置文件的客户端。

选择你的客户端。

Claude.ai（自定义连接器）

Pro 和 Max：前往 Settings → Connectors → Add custom connector。粘贴 URL，点击 Add，然后 点击 Connect 并登录。

Team 和 Enterprise：所有者先前往 Organization settings → Connectors → Add 添加连接器，将鼠标悬停在 Custom 上，选择 Web，然后粘贴 URL。成员随后可从各自的 Settings → Connectors 中连接。

https://adako.ai/mcp

可添加的自定义连接器数量取决于你的 Claude 套餐。

Claude Desktop

设置方式与 Claude.ai 的 Connectors 相同 — 使用上面的 URL 添加自定义连接器，然后在提示时登录。 桌面应用与 Claude 账户共用，因此在网页端添加的连接器也可在此使用。 完整指南：clients/claude-desktop.md。

Claude Code

claude mcp add --transport http adako https://adako.ai/mcp

然后在会话中运行 /mcp，并选择 adako，通过浏览器登录。

使用 --scope user 为每个项目添加一次：

claude mcp add --transport http adako https://adako.ai/mcp --scope user

API 密钥方式，无需使用浏览器：

claude mcp add --transport http adako https://adako.ai/mcp \
  --header "Authorization: Bearer ak_live_your_key"

此外，还有一个插件，可一步安装服务、技能、设置命令和运维 Agent：

/plugin marketplace add ruslan2027/adako-mcp
/plugin install adako@adako
/adako-setup

请参阅 clients/claude-code.md 和 plugin/。

ChatGPT（开发者模式）

1. 在 Settings → Security & login 下开启 Developer mode，然后 打开 ChatGPT Plugins。
2. 点击 +。将 Adako 设为连接名称，并将 https://adako.ai/mcp 设为 MCP 服务 URL。 添加简短描述，选择公共端点连接选项，然后点击 Create。
3. 如出现提示，请完成授权。
4. 开始新对话，打开工具菜单，然后选择 Adako。

完整指南：clients/chatgpt.md。

Cursor

一条命令，可重复执行且不会影响其他服务：

node install/cursor.mjs            # the home-folder .cursor/mcp.json
node install/cursor.mjs --project  # .cursor/mcp.json in this repository

也可以自行编写文件：

{
  "mcpServers": {
    "adako": {
      "url": "https://adako.ai/mcp"
    }
  }
}

完整文件：clients/cursor/mcp.json。指南： clients/cursor.md。

此仓库也是 Cursor 插件，可用于 Cursor Marketplace： .cursor-plugin/plugin.json 会添加服务和 skills/ 中的技能。

Codex CLI

codex mcp add adako --url https://adako.ai/mcp
codex mcp login adako

也可以运行安装程序，它会重写 Codex 配置中的一个表（Windows 上为 C:\Users\<you>\.codex\config.toml，macOS 上为 /Users/<you>/.codex/config.toml），并保留文件的其余内容不变：

node install/codex.mjs            # API key from $ADAKO_API_KEY
node install/codex.mjs --oauth    # sign in with codex mcp login instead

完整文件：clients/codex/config.toml。指南： clients/codex.md。

Windsurf

node install/windsurf.mjs

也可以在 Windows 上将代码块手动添加到 C:\Users\<you>\.codeium\windsurf\mcp_config.json，或在 macOS 上添加到 /Users/<you>/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

完整文件：clients/windsurf/mcp_config.json。指南： clients/windsurf.md。

Gemini（自定义应用）

在电脑上打开 gemini.google.com/apps，或前往 Settings → Connected apps，然后向下滚动到最底部的 Custom apps，选择 Add a custom app，并粘贴 URL：

https://adako.ai/mcp

点击 Next 并登录。将 Advanced features 下的凭据字段留空：Adako 会自行注册。在聊天中输入 @，然后选择 Adako。

指南：clients/gemini.md。自定义应用仍在逐步推出，且受 Google 列出的条件限制：个人 Google Account、使用英语、位于美国、年满 18 岁。

Antigravity（应用、IDE 和 agy CLI）

这三者都读取同一个文件，因此只需添加一次 Adako。在桌面应用中：Settings → Customizations， 然后选择 Open MCP Config。在 IDE 中：打开 Agent 侧边栏，选择 … → MCP Servers。在 CLI 中： 使用 /mcp，或直接编辑文件——Windows 上为 C:\Users\<you>\.gemini\config\mcp_config.json，macOS 上为 /Users/<you>/.gemini/config/mcp_config.json（Linux：/home/<you>/.gemini/config/mcp_config.json）。要用于单个项目，请使用 .agents/mcp_config.json。保存后，点击 Installed MCP Servers 旁边的 refresh，然后点击 Adako 登录。

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

Antigravity 会在首次调用时通过浏览器登录。指南： clients/antigravity.md。

Gemini CLI 已于 2026 年 6 月 18 日停止为免费账户和 Pro 账户提供服务，现在仅支持付费 Gemini 和 Gemini Enterprise API 密钥。如果你仍在使用它，旧的写法仍然有效：在主目录下的 .gemini/settings.json 中使用 httpUrl，并使用扩展清单 gemini-extension.json 和 clients/gemini-cli/gemini-extension.json。另外， agy plugin import gemini 可以将现有配置导入 Antigravity。

VS Code（Copilot）

在工作区中使用 .vscode/mcp.json，或使用用户级 mcp.json：

{
  "servers": {
    "adako": {
      "type": "http",
      "url": "https://adako.ai/mcp"
    }
  }
}

VS Code 会处理 OAuth 流程。包含 API 密钥变体的完整文件： clients/vscode/mcp.json。指南：clients/vscode.md。

Perplexity

添加 Adako 作为自定义连接器：在网页上访问 perplexity.ai/computer/connectors，或在桌面应用中选择 Settings → Connectors，然后使用 OAuth 访问上方的 URL。Pro、Max 和 Enterprise 套餐均包含自定义连接器。指南：clients/perplexity.md。

---

添加技能

skills/ 包含 11 个 Agent Skills。adako 是操作流程：安全约定、工具调用约定、工具索引和工作流。其他技能各有侧重：每个平台一个，每项工作一个。

技能	用途
adako	操作流程。从这里开始。
google-ads、meta-ads、tiktok-ads、linkedin-ads、chatgpt-ads	每个平台一个：按工作分类的工具、规则、启动顺序
launch	在任何平台上安全地创建广告系列
performance-review	用可靠的数据回答“效果如何”
optimize	评估之后应做哪些调整，以及调整顺序
creative	各平台的文案限制和素材规格，以及疲劳应对指南
monitoring	监控、提醒、简报和报告

• Claude Code — 安装插件，或将 skills/ 复制到主目录下的 .claude/skills/ 文件夹（Windows 上为 C:\Users\<you>\.claude\skills\，macOS 上为 /Users/<you>/.claude/skills/）。
• claude.ai — 在设置中上传 SKILL.md（与 skills/adako/SKILL.md 相同的文件）作为技能。
• 其他工具 — 将内容粘贴到系统提示词或项目说明中。

连接时，服务端也会提供简短说明，因此技能是可选的。它们能显著提升长时间会话的稳定性。

---

REST API 和命令行

相同的工具也可通过 HTTP 和 API 密钥调用。

curl -X POST https://adako.ai/api/v1/tools/google_get_campaign_performance/execute \
  -H "Authorization: Bearer ak_live_your_key" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"date_range": "last_30_days"}}'

GET /api/v1/tools 会列出所有可调用的工具。GET /api/v1/openapi.json 是机器可读的约定，n8n、Zapier 和 Make 均可导入。完整参考文档： adako.ai/docs/api。

adako 命令行封装了相同的端点，供脚本和编码 Agent 使用：

npx @adako/cli login
npx @adako/cli google list-campaigns --customer-id 1234567890
npx @adako/cli meta get-campaign-performance --date-range last_30_days --raw

源代码位于 cli/：纯 ESM，无依赖，需要 Node 22 或更高版本。已发布的包为 npm 上的 @adako/cli。

---

连接你的账户

1. 在 adako.ai 登录。
2. 打开 Accounts 并连接一个平台。Google Ads 和 LinkedIn Ads 通过平台登录；Meta Ads 使用你自己的 Meta 应用中系统用户的访问令牌；ChatGPT Ads 使用广告主 API 密钥。你无需向 AI 客户端提供密码或令牌。
3. 开启 Adako 可以操作的账户，并为每个平台选择主要账户。
4. 返回助手并说 “从这里开始”。

---

首批提示词

只读操作，因此不会有任何变更：

• "从这里开始。"
• "我连接了哪些广告账户？"
• "过去 30 天我的 Google 广告系列表现如何？与之前 30 天相比呢？"
• "找出上个月有花费但没有转化的搜索字词。"
• "本周哪些 Meta 广告组有花费却没有成效？"
• "按版位细分我表现最好的 Meta 广告组。"
• "我的哪些 TikTok 广告出现了创意疲劳？"
• "上个月 LinkedIn 的每条潜在客户成本是多少？触达了哪些职位？"
• "在我所有活跃账户中运行这项浪费支出检查。"

然后，当你想进行更改时：

• "从该列表中建议 10 个否定关键字，并说明每个关键字会屏蔽什么。"
• "暂停花费最高但没有转化的广告系列。"
• "将 Brand Search 的每日预算提高到 40。"
• "为 {product} 起草一个已暂停的 Search 广告系列，定位 {city}，每日预算 25。"
• "如果 CPA 连续两天超过 80，就提醒我，并在每周一发送简报。"

以上每项操作都会以一项提案结束，由你决定批准还是拒绝。

---

定价

免费版包含 1 个广告账户和每月 30 项任务。Pro（每月 $49）涵盖 5 个广告账户和每月 600 项任务，Agency（每月 $149）涵盖 20 个账户和 5,000 项任务；Enterprise 按合同定价。在一个计费周期内使用过的账户会保留名额，直到周期重置。一项任务是对广告账户进行的一次计费更改；读取以及连接、用量、提案、发现、诊断和问题解决工具均免费。监控器、定时简报和生成的报告需要 Pro 或更高版本。详情请访问 adako.ai/pricing。

文档

adako.ai/docs — 快速入门、每个客户端一页、每个平台一页、工具范围、工作流、监控器、完整的工具参考和 REST API。

支持

[email protected] · 安全问题报告：请参阅 SECURITY.md · 变更：请参阅 CHANGELOG.md

许可证

本仓库中的技能和客户端配置采用 MIT 许可证 — 请参阅 LICENSE。托管的 Adako 服务为专有服务。