apple-ads-mcp
向您的 AI 提问,例如:
"我的广告系列上周表现如何?" "暂停品牌广告系列,并将发现广告系列的预算提高到 500 美元。" "哪些搜索词触发了我的广告?将最佳搜索词添加为精确匹配关键词。"
支持 54 个工具、3 个资源和 6 个提示 — 广告系列、广告组、关键词、创意、预算、搜索词、地理位置定位、展示份额和效果报告。
功能一览
功能 | 描述 |
广告系列管理 | 创建、更新、暂停和删除广告系列和广告组 |
关键词优化 | 添加/移除定向关键词和否定关键词,更新出价 |
效果报告 | 按日期预设获取广告系列、广告组、关键词、广告和地理报告 |
搜索词分析 | 查看触发广告的实际搜索查询 |
创意管理 | 管理广告、创意和产品页面 |
预算控制 | 创建和管理预算订单,分析利用率 |
展示份额 | 生成和获取自定义展示份额报告 |
多组织支持 | 在运行时切换组织 |
快速开始
获取您的 Apple 凭据(约 10 分钟,一次性)
生成您的密钥对(2 条命令)
开始聊天
Related MCP server: google-ads-mcp
设置
第 1 步 — 邀请 API 用户
由账户管理员在 searchads.apple.com 完成。
前往设置 → 用户管理 → 邀请用户
输入将使用 API 的人员的电子邮件
设置角色:
API 账户管理员 — 完全读写权限
API 账户只读 — 仅查看权限
发送邀请
API 用户必须是与管理员的不同 Apple ID。如果您是管理员,请使用第二个 Apple ID。
第 2 步 — 接受并复制您的凭据
由受邀用户完成。
接受电子邮件邀请并登录 searchads.apple.com
前往设置 → API 标签页
复制并保存以下三个值:
clientId — 以
SEARCHADS.开头teamId — 以
SEARCHADS.开头keyId — 一个 UUID
第 3 步 — 生成您的密钥对
打开终端并运行:
openssl ecparam -genkey -name prime256v1 -noout -out ~/apple-ads-key.pem && \
openssl pkcs8 -topk8 -nocrypt -in ~/apple-ads-key.pem -out ~/apple-ads-key-pkcs8.pem然后生成公钥:
openssl ec -in ~/apple-ads-key-pkcs8.pem -pubout -out ~/apple-ads-key-public.pem这将创建:
~/apple-ads-key-pkcs8.pem— 私钥(请妥善保管,用于您的配置)~/apple-ads-key-public.pem— 公钥(接下来上传到 Apple)
第 4 步 — 将公钥上传到 Apple
打印您的公钥:
cat ~/apple-ads-key-public.pem复制整个输出(包括 BEGIN / END 行),然后:
前往 searchads.apple.com 上的设置 → API 标签页
粘贴到公钥字段
保存
第 5 步 — 添加到您的 MCP 客户端
在下方选择您的客户端,并填写第 2 步中的 clientId、teamId 和 keyId,以及第 3 步中私钥的完整路径。
有多个组织? 省略
ASA_ORG_ID,并在运行时使用list_organizations/switch_organization。或者将其设置在env中以选择默认组织。
客户端
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": ["-y", "apple-ads-mcp"],
"env": {
"ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem"
}
}
}
}保存后重启 Claude Desktop。
claude mcp add apple-ads \
-e ASA_CLIENT_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
-e ASA_TEAM_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
-e ASA_KEY_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
-e ASA_PRIVATE_KEY_PATH=/Users/yourname/apple-ads-key-pkcs8.pem \
-- npx -y apple-ads-mcp添加到 .cursor/mcp.json:
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": ["-y", "apple-ads-mcp"],
"env": {
"ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem"
}
}
}
}添加到您的 settings.json:
{
"mcp": {
"servers": {
"apple-ads": {
"command": "npx",
"args": ["-y", "apple-ads-mcp"],
"env": {
"ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem"
}
}
}
}
}添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": ["-y", "apple-ads-mcp"],
"env": {
"ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem"
}
}
}
}此服务器使用 STDIO 传输。任何兼容 MCP 的客户端都可以通过运行以下命令连接:
npx -y apple-ads-mcp设置以下环境变量:
变量 | 描述 |
| 您的客户端 ID(以 |
| 您的团队 ID(以 |
| 您的密钥 ID(UUID) |
| 您的 PKCS#8 私钥的绝对路径 |
| (可选) 默认使用的组织 ID |
将 ASA_PRIVATE_KEY_PATH 替换为 ASA_PRIVATE_KEY,并粘贴 PEM 内容,使用 \n 表示换行:
"ASA_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nMIGH...your-key...\n-----END PRIVATE KEY-----"工具
类别 | 数量 | 功能说明 |
组织 | 3 | 列出并切换组织。获取用户详细信息。 |
广告系列 | 6 | 列出、创建、更新、删除广告系列。获取效果报告。 |
广告组 | 6 | 管理广告系列中的广告组。获取广告组报告。 |
关键词 | 11 | 添加/移除定向关键词和否定关键词。更新出价。关键词报告。 |
搜索词 | 1 | 查看用户点击您的广告之前实际搜索的查询。 |
广告 | 7 | 列出、创建、更新、删除广告。获取广告报告和拒绝原因。 |
创意 | 5 | 管理创意和产品页面。 |
预算订单 | 4 | 创建、更新、列出和获取预算订单详细信息。 |
应用与地理位置 | 5 | 搜索符合条件的应用,检查资格,查找资源,搜索地理位置。 |
地理效果 | 1 | 按国家/地区划分的效果明细。 |
展示份额 | 3 | 创建、列出和获取自定义展示份额报告。 |
优化 | 2 | 广告系列快照和预算利用率分析。 |
全部 54 个工具
类别 | 工具 |
组织 |
|
广告系列 |
|
广告组 |
|
关键词 |
|
搜索词 |
|
广告 |
|
创意 |
|
预算订单 |
|
应用与地理 |
|
地理表现 |
|
展示份额 |
|
优化 |
|
资源
服务器提供 3 个资源:
URI | 描述 |
| Apple Search Ads 支持的国家和地区 |
| 创意素材的应用预览设备尺寸 |
| 所有报告指标(CPA、CPT、TTR 等)的定义、公式和基准 |
提示
6 个内置工作流提示,用于指导常见任务:
提示 | 描述 |
| 综合广告系列分析 — 审查支出、转化、CPA 趋势并标记问题 |
| 关键词和搜索词优化工作流 — 发现浪费的支出和新的机会 |
| 引导式新广告系列创建 — 逐步完成应用选择、结构、关键词和预算 |
| 跨广告系列预算分析 — 识别超支/支出不足并提出预算调整 |
| 创意 A/B 审查 — 比较广告表现、标记拒绝、推荐优胜者 |
| 地理扩展分析 — 对当前市场进行排名并识别要进入的新市场 |
"pkcs8 必须是 PKCS#8 格式的字符串" 您的密钥格式不正确。请从步骤 3重新运行
openssl pkcs8命令。
"未选择组织" 使用
list_organizations然后switch_organization,或将ASA_ORG_ID添加到您的配置中。
"令牌请求失败 (401)" 验证您的 clientId、teamId 和 keyId 与 Apple 的 API 标签页匹配。检查您是否上传了公钥。
"读取私钥失败" 使用绝对路径(例如
/Users/yourname/...),而不是~/...。
服务器立即断开连接 缺少必需的凭据。您需要全部四个:
ASA_CLIENT_ID、ASA_TEAM_ID、ASA_KEY_ID和ASA_PRIVATE_KEY_PATH。
git clone https://github.com/javiergalloroca/AppleAdsMCP.git
cd AppleAdsMCP
npm install
npm run build
npm start热重载:npm run dev
参见 CONTRIBUTING.md 了解贡献指南。
许可证
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Apple Search Ads MCP: campaign analytics, bid management, and attribution tracking.
Meta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.
Google Ads MCP server — manage campaigns, keywords, and metrics.
Google Ads MCP server: run Search, Display, Demand Gen and PMax campaigns from AI.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server exposing the full Apple Ads (Search Ads) Campaign Management API v5 — 74 typed tools7494 npm11MIT

google-ads-mcpofficial
AlicenseBqualityAmaintenanceMCP server that provides tools and resources for interacting with Google Ads API, enabling search, metadata retrieval, and account management through natural language.76,309 PyPI1,193Apache 2.0- AlicenseBqualityDmaintenanceMCP server for Meta Ads providing 30 tools for account discovery, campaign management, targeting research, and insights. Designed with LLM-friendly outputs and productivity features like cloning and bulk operations.311MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for managing App Store Optimization: add apps, track keywords, pull health reports, spy on competitors, find keyword opportunities, and write AI copy suggestions.8MIT