Ads MCP

广告MCP

用于跨平台广告管理的远程模型上下文协议（MCP）服务器。创建、分析和优化跨平台的活动 谷歌广告、元广告、TikTok广告和领英广告 来自任何兼容MCP的AI助手。

快速链接

• MCP远程URL: https://mcp.adspirer.com/mcp
• 运输： 可流式传输的HTTP
• 注册表ID: com.adspirer/ads
• 身份验证： OAuth 2.1与PKCE（支持动态客户端注册）
• 网站： https://www.adspirer.com
• 技术支持： support@adspirer.com

它做什么

• 战略意识执行 --战略决策坚持 STRATEGY.md 并指导所有未来的活动创建、关键字研究和跨会话和子代理的广告文案
• 175+工具 跨4个广告平台，用于活动创建、绩效分析和优化
• 使用结构化提示计划和验证活动
• 使用真实的CPC数据和竞争分析研究关键字
• 创建谷歌广告搜索，最大性能（具有搜索主题+受众信号）， 显示 （标准+智能）， 需求生成，以及端到端的YouTube广告系列
• 启动元图像/视频/旋转木马/OUTCOME_LEADS活动、领英赞助的内容/旋转木马/与活动组合作的潜在客户表单，以及TikTok的feed/Spark Ads/旋转木马/App推广活动
• 使用可操作的优化建议分析性能——浪费支出、异常检测、受众洞察、创意疲劳
• 原始数据模式 (raw_data=true)在所有29个性能/分析工具上——仅JSON输出，用于您自己的归因、仪表板或令牌高效管道
• 多账户、多平台——代理商可以从一个工作区管理每个平台的多个广告账户
• 自动化——在所有四个平台上安排简报、性能监控、按需跨平台报告

平台和工具

如何连接

看 连接.md 了解每个平台的详细设置说明。

克劳德（推荐）

1. 打开 设置>连接器>添加自定义连接器
2. 姓名： 广告MCP
3. 网址： https://mcp.adspirer.com/mcp
4. 完成OAuth 2.1登录
5. 首次使用时链接您的广告帐户

克劳德代码

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

1. 打开克劳德代码
2. 跑 /plugin marketplace add amekala/ads-mcp
3. 跑 /plugin install adspirer
4. 跑 /mcp --查找 插件：adspirer：adspirer 并单击以进行身份验证
5. 跑 /adspirer:setup 提取您的活动数据并创建您的品牌工作区

这为您提供了一个具有品牌意识的绩效营销代理，具有持久记忆、通过网络搜索进行竞争研究、使用广告扩展创建活动以及常见工作流程的斜线命令。 启用子代理使用不会更改此安装流程。

仅限MCP（无插件）： 如果你只想要没有代理的原始MCP工具：

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

ChatGPT

1. 打开 设置>连接器>添加自定义连接器
2. 姓名： 广告MCP
3. 网址： https://mcp.adspirer.com/mcp
4. 遵循OAuth 2.1登录流程

光标

添加 ~/.cursor/mcp.json:

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

OpenAI 代码专家

添加 ~/.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 plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect

或从以下位置安装 技能商店.

困惑、马努斯和其他MCP客户

Adspirer是一个标准的MCP服务器——任何支持OAuth 2.1的MCP连接器的客户端（困惑、Manus AI、自定义MCP客户端）都可以连接到 https://mcp.adspirer.com/mcp.Manus还通过流式HTTP传输接受API密钥。

REST API（不需要MCP客户端）

同一工具表面在以下位置显示为178个REST端点 https://api.adspirer.ai/api/v1/tools//execute.使用个人访问令牌进行身份验证(sk_live_...)创建于 adspirer.ai/关键.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）
• 运输： 可流式传输的HTTP
• OAuth： RFC 8252（授权码+PKC）与RFC 7591（动态客户端注册）和RFC 9728（受保护资源元数据）
• 工具注释： 所有工具均包含MCP安全元数据(readOnlyHint, destructiveHint)

安全

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

看 安全.md 用于漏洞报告。

文档

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

支持

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

支持的插件

该仓库从一个单一仓库分发4个AI平台的插件：

Claude Code、Cursor和Codex的技能在 shared/skills/ 作为模板，然后通过以下方式编译成IDE特定版本 scripts/sync-skills.sh. 绩效营销代理提示也是一次性编写的 shared/agents/performance-marketing-agent/PROMPT.md 并通过相同的同步脚本编译成Claude Code、Cursor和Codex代理文件。 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/ad-campaign-management/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

客户端根目录和安装目标

开发者指南

如果您正在为此仓库做出贡献或添加新的广告平台/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/ 相反。

许可证

专有——见 服务条款 关于使用条款。