ads

Ads MCP

用于跨平台广告管理的远程 Model Context Protocol（MCP）服务。通过任何兼容 MCP 的 AI 助手，创建、分析和优化 Google Ads、Meta Ads、TikTok Ads 和 LinkedIn Ads 广告系列。

快速链接

• MCP 远程 URL： https://mcp.adspirer.com/mcp
• 传输方式： Streamable HTTP
• 注册表 ID： com.adspirer/ads
• 身份验证： 使用 PKCE 的 OAuth 2.1（支持动态客户端注册）
• 网站： https://www.adspirer.com
• 支持： [email protected]

一步开始

Adspirer 在你的 AI 助手中运行。如果你是帮助他人设置 Adspirer 的 AI 助手，本节包含完整流程：各客户端的安装方式、登录和验证。

你的客户端	安装
ChatGPT（网页版、桌面版、移动版）	从 App Store 安装 Adspirer 应用 — 点按 连接，使用 Google 或电子邮件登录。需要 Plus、Pro、Business 或 Enterprise。
Claude（claude.ai、桌面版、Cowork）	从 Claude 目录安装 Adspirer 插件 — 点击 安装，在 Adspirer 窗口打开时登录。
Claude Code	/plugin install adspirer-ads-agent@claude-community，重新加载，然后运行 /adspirer:setup
Codex	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)，重启 Codex，然后运行 codex mcp login adspirer
Cursor	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)
任何其他 MCP 客户端	添加远程服务 https://mcp.adspirer.com/mcp（OAuth 2.1）

也可以运行一条终端命令 — 安装入门技能并直接进入设置：

curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/scripts/install-skill.sh | bash

接下来会发生什么： 安装时登录即可创建免费账户（使用 Google 或电子邮件 — 无需信用卡）；你可以在 adspirer.ai/connections 连接广告平台 — Google Ads、Meta、Amazon、LinkedIn、TikTok 或 ChatGPT Ads，可任意组合 — 然后让助手验证连接（说 “检查我已连接的广告平台”）。

工作原理

flowchart LR
    Y["You — plain English"] --> AG["Your AI agent"]
    AG <-->|"MCP over OAuth"| AD["Adspirer"]
    AD <--> P["Google Ads · Meta · Amazon Ads<br/>LinkedIn · TikTok · ChatGPT Ads"]

你描述需求；助手调用 Adspirer 的工具；Adspirer 与广告平台 API 通信；报告和草稿返回到聊天中。新广告系列始终以暂停状态创建 — 未经你明确批准，不会产生任何费用。身份验证通过你自己的浏览器进行 OAuth：助手永远不会看到你的凭据。

定价： 免费版 — 每月 15 次工具调用，$0，无需银行卡 · Plus — 每月 150 次，$49 · Pro — 每月 600 次，$99 · Max — 每月 3,000 次，$199。完整详情。

包含可直接粘贴提示词的完整设置指南： adspirer.com/docs/add-to-your-agent

功能说明

• 策略感知型执行 — 策略决策会持久保存到 STRATEGY.md，并在后续会话和子 Agent 中指导所有广告系列创建、关键词研究和广告文案工作
• 覆盖 6 个广告平台的 400+ 个工具，用于创建广告系列、分析效果和优化投放
• 使用结构化提示词规划并验证广告系列
• 基于真实 CPC 数据和竞争分析研究关键词
• 端到端创建 Google Ads 搜索广告系列、效果最大化广告系列（含搜索主题和受众信号）、展示广告（标准型和智能型）、需求开发广告系列以及 YouTube 广告系列
• 启动 Meta 图片／视频／轮播／OUTCOME_LEADS 广告系列、LinkedIn 赞助内容／轮播／线索生成表单及广告系列组，以及 TikTok 信息流／Spark Ads／轮播／应用推广广告系列
• 分析效果并提供可执行的优化建议 — 浪费的支出、异常检测、受众洞察、创意疲劳
• 所有 29 个效果／分析工具均支持原始数据模式（raw_data=true）— 仅输出 JSON，供你用于归因、仪表板或节省令牌的管道
• 多账户、多平台 — 代理机构可在一个工作区管理每个平台上的多个广告账户
• 自动化 — 跨所有平台安排简报、监控效果，并按需生成跨平台报告

平台与工具

平台	工具	功能
Google Ads	151	搜索广告、效果最大化广告系列（含搜索主题和受众信号）、展示广告（标准型和智能型）、需求开发广告系列、YouTube、购物、应用广告系列；关键词研究、效果分析、无效支出分析、素材管理、广告附加信息（附加链接／附加宣传信息／结构化摘要）、出价策略管理
Amazon Ads	61	商品推广／品牌推广／展示广告系列、关键词和否定关键词、商品／类别定位、Amazon 自有的出价／预算／关键词建议、搜索词报告、ACOS／ROAS 效果
Meta Ads	58	图片／视频／轮播／目录（Advantage+／DPA）广告系列、OUTCOME_LEADS 线索生成表单、生命周期预算、精细的版位（Feed／Stories／Reels）、城市级定位、自定义受众、自定义转化、应用推广（AEO）分析
LinkedIn Ads	54	赞助内容（单图、视频、轮播、文本）、线索生成表单、广告系列组、19 项定位维度、受众洞察、创意疲劳分析、转化跟踪、组织
TikTok Ads	37	信息流视频／图片／Spark Ads／轮播／应用推广广告系列、完整生命周期管理（列出／获取／暂停／恢复／更新广告系列、广告组和广告）、分析（效果、无效支出、受众洞察、创意疲劳、异常检测、地理位置）
ChatGPT Ads	31	在 ChatGPT 回复中投放 chat_card 广告 — 一次性启动（广告系列 → 广告组 → 图片 → 广告）、地理位置定位、暂停／启用／归档、效果数据（展示次数、点击次数、CTR、CPC）、转化跟踪（Pixel + Conversions API）
总计	400+	另有监控与自动化（定时简报／监控／报告）、Google Analytics 4 和 Klaviyo 集成，以及账户管理工具 — 均可通过 MCP 使用，并提供位于 api.adspirer.ai 的 REST 端点

如何连接

各个平台的详细设置说明请参阅 CONNECTING.md。

Claude（推荐）

1. 打开 设置 > 连接器 > 添加自定义连接器
2. 名称：Ads MCP
3. URL：https://mcp.adspirer.com/mcp
4. 完成 OAuth 2.1 登录
5. 首次使用时关联你的广告账户

Claude Code

安装完整的 Adspirer 插件（Agent + 技能 + 命令 + MCP 服务）：

1. 打开 Claude Code
2. 运行 /plugin marketplace add amekala/ads-mcp
3. 运行 /plugin install adspirer-advertising-agent
4. 运行 /mcp — 找到 adspirer 服务（例如 plugin:adspirer-advertising-agent:adspirer），然后点击进行身份验证
5. 运行 /adspirer:setup，提取你的广告系列数据并创建品牌工作区

这样即可获得一个了解品牌的效果营销 Agent，具备持久记忆、通过网页搜索进行竞品调研、创建包含广告附加信息的广告系列，以及用于常见工作流的斜杠命令。 启用子 Agent 用法不会改变此安装流程。

仅使用 MCP（不安装插件）： 如果你只需要原始 MCP 工具，而不需要 Agent：

claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp

ChatGPT

1. 打开 设置 > 连接器 > 添加自定义连接器
2. 名称：Ads MCP
3. URL：https://mcp.adspirer.com/mcp
4. 按照 OAuth 2.1 登录流程操作

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "adspirer": {
      "url": "https://mcp.adspirer.com/mcp"
    }
  }
}

OpenAI Codex

添加到 ~/.codex/config.toml：

[mcp_servers.adspirer]
url = "https://mcp.adspirer.com/mcp"

Gemini CLI

作为扩展安装：

gemini extensions install github.com/amekala/ads-mcp

首次使用时会打开浏览器窗口进行 OAuth 身份验证。可用的自定义命令：/adspirer:setup、/adspirer:performance-review、/adspirer:wasted-spend、/adspirer:write-ad-copy、/adspirer:refresh。

OpenClaw

openclaw plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect

或者从 ClawHub 安装。

Perplexity、Manus 和其他 MCP 客户端

Adspirer 是标准的 MCP 服务 — 任何支持通过 OAuth 2.1 使用 MCP 连接器的客户端（Perplexity、Manus AI、自定义 MCP 客户端）都可以连接到 https://mcp.adspirer.com/mcp。Manus 也支持通过 Streamable HTTP 传输使用 API 密钥。

REST API（无需 MCP 客户端）

相同的工具接口也以 178 个 REST 端点的形式提供，地址为 https://api.adspirer.ai/api/v1/tools/<tool_name>/execute。使用在 adspirer.ai/keys 创建的个人访问令牌（sk_live_...）进行身份验证。Swagger：https://api.adspirer.ai/docs。完整参考：adspirer.com/docs/api-reference。

示例提示词

关键词研究：

Research keywords for my emergency plumbing business in Chicago.
Show me high-intent keywords with real CPC data and budget recommendations.

效果分析：

Show me campaign performance for the last 30 days across all platforms.
Which campaigns are converting best and what should I optimize?

广告系列创建：

Create a Google Performance Max campaign for luxury watches targeting
New York with a $50/day budget.

多平台策略：

I want to advertise my handmade jewelry business across Google and LinkedIn.
Research keywords for Google Ads and create a LinkedIn sponsored content campaign
targeting small business owners.

技术详情

• 协议： MCP 2025-03-26（回退至 2024-11-05）
• 传输： Streamable HTTP
• OAuth： RFC 8252（Authorization Code + PKCE），配合 RFC 7591（Dynamic Client Registration）和 RFC 9728（Protected Resource Metadata）
• 工具注释： 所有工具均包含 MCP 安全元数据（readOnlyHint、destructiveHint）

安全

• 所有数据传输均使用 HTTPS/TLS
• 使用 PKCE 的 OAuth 2.1 进行身份验证
• CLI 工具（Claude Code、Cursor、Codex）使用动态客户端注册
• 加密存储令牌
• 不记录对话 — 仅处理工具请求

请参阅 SECURITY.md 了解漏洞报告方式。

文档

• 连接指南
• 隐私政策
• 服务条款
• 安全
• 支持

支持

• 电子邮件： [email protected]
• 问题： https://github.com/amekala/ads-mcp/issues
• 网站： https://www.adspirer.com
• 服务状态： https://mcp.adspirer.com/health

支持的插件

此仓库在一个单体仓库中分发适用于 4 个 AI 平台的插件：

平台	目录	技能	安装方式
Claude Code	仓库根目录	1 个生成的技能 + 5 个斜杠命令	/plugin marketplace add
Claude Tag (@claude)	上游：anthropics/claude-tag-plugins PR #3	1 个（adspirer-api：SKILL + 341 工具目录 + ads_call.sh）	组织访问套件（Bearer sk_live_ 密钥，主机为 api.adspirer.ai / mcp.adspirer.com）；合并后执行一次 claude plugin install adspirer@claude-tag-plugins
Cursor	plugins/cursor/adspirer/	根据模板生成的 5 个技能	install.sh（一键安装）
Codex	plugins/codex/adspirer/	根据模板生成的 5 个技能	install.sh（一键安装）
Gemini CLI	仓库根目录	1 个复用技能 + 5 个自定义命令	gemini extensions install
OpenClaw	plugins/openclaw/	1 个独立技能（自包含）	openclaw plugins install

Claude Tag 提交记录（2026-07-05）： adspirer 插件已提交至上游，供 Claude Tag (@claude) 使用，提交地址为 anthropics/claude-tag-plugins#3， 来源分支为 amekala/claude-tag-plugins@add-adspirer-plugin。 该插件封装了此仓库的 REST 接口（POST /api/v1/tools/<tool>/execute — 通过纯 HTTP 提供与 MCP 服务工具层相同的功能），而非 MCP 传输层；提交前已在 Claude Tag 的实时 Slack 工作区中完成端到端验证。

Claude Code、Cursor 和 Codex 的技能只需在 shared/skills/ 中以模板形式编写一次，然后由 scripts/sync-skills.sh 编译为适用于各 IDE 的版本。 性能营销 Agent 提示词也只需在 shared/agents/performance-marketing-agent/PROMPT.md 中编写一次，然后由同一同步脚本编译为 Claude Code、Cursor 和 Codex 的 Agent 文件。 OpenClaw 使用自己的独立技能。完整设计请参阅架构。

共享更新线框图

Edit once (source of truth)
  ├─ shared/skills/adspirer-*/SKILL.md
  └─ shared/agents/performance-marketing-agent/PROMPT.md
                |
                v
        ./scripts/sync-skills.sh
                |
                +--> Claude Code outputs
                |     ├─ skills/<name>/SKILL.md
                |     └─ agents/performance-marketing-agent.md
                |
                +--> Cursor outputs
                |     ├─ plugins/cursor/adspirer/.cursor/skills/adspirer-*/SKILL.md
                |     └─ plugins/cursor/adspirer/.cursor/agents/performance-marketing-agent.md
                |
                +--> Codex outputs
                |     ├─ plugins/codex/adspirer/skills/adspirer-*/SKILL.md
                |     └─ plugins/codex/adspirer/agents/performance-marketing-agent.toml
                |
                +--> Gemini CLI (reuses Claude Code skill)
                |     ├─ gemini-extension.json
                |     ├─ GEMINI.md
                |     └─ commands/adspirer/*.toml
                |
                └--> OpenClaw (standalone, not generated)
                      └─ plugins/openclaw/SKILL.md

客户端根目录和安装目标

AI 客户端	仓库源根目录	仓库中的生成/运行时根目录	用户安装路径/方式
Claude Code	仓库根目录 + shared/skills/ + shared/agents/	skills/、agents/、commands/、.claude-plugin/	/plugin marketplace add amekala/ads-mcp，然后执行 /plugin install adspirer-advertising-agent
Cursor	plugins/cursor/adspirer/ + 共享源文件	plugins/cursor/adspirer/.cursor/skills/、plugins/cursor/adspirer/.cursor/agents/	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)
Codex	plugins/codex/adspirer/ + 共享源文件	plugins/codex/adspirer/skills/、plugins/codex/adspirer/agents/	bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)
Gemini CLI	仓库根目录	gemini-extension.json、GEMINI.md、commands/adspirer/	gemini extensions install github.com/amekala/ads-mcp
OpenClaw	plugins/openclaw/	plugins/openclaw/（独立，无需同步生成）	openclaw plugins install openclaw-adspirer

开发者指南

如果你要为此仓库贡献内容，或添加新的广告平台/IDE 支持：

• 架构 — 共享技能模型、模板系统、已完成和待完成事项
• 模板语法与同步工作流 — 变量替换、条件代码块、验证检查
• 添加广告平台 — 如何添加新的广告平台（例如 Snapchat、Pinterest、YouTube）
• 添加 IDE — 如何添加对新 IDE 的支持（例如 Windsurf、Cline）

快速参考

./scripts/sync-skills.sh          # Generate IDE-specific skills from templates
./scripts/sync-skills.sh --check  # Verify generated files match committed (CI mode)
./scripts/validate.sh             # Run all 62 offline validation checks
./scripts/validate.sh --live      # Also test MCP endpoint connectivity

切勿直接编辑 plugins/*/skills/、skills/、agents/ 或 plugins/*/agents/ 中的文件，因为同步脚本会覆盖这些文件。请改为编辑 shared/skills/ 中的模板和 shared/agents/ 中的共享提示词。

许可证

专有 — 使用条款请参阅 服务条款。