Skip to main content
Glama
deenesjakozh
Happygallo

apple-ads-mcp

by Happygallo
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

向您的 AI 提问，例如：

"我的广告系列上周表现如何？" "暂停品牌广告系列，并将发现广告系列的预算提高到 500 美元。" "哪些搜索词触发了我的广告？将最佳搜索词添加为精确匹配关键词。"

支持 54 个工具、3 个资源和 6 个提示 — 广告系列、广告组、关键词、创意、预算、搜索词、地理位置定位、展示份额和效果报告。

功能一览

功能

描述

广告系列管理

创建、更新、暂停和删除广告系列和广告组

关键词优化

添加/移除定向关键词和否定关键词，更新出价

效果报告

按日期预设获取广告系列、广告组、关键词、广告和地理报告

搜索词分析

查看触发广告的实际搜索查询

创意管理

管理广告、创意和产品页面

预算控制

创建和管理预算订单，分析利用率

展示份额

生成和获取自定义展示份额报告

多组织支持

在运行时切换组织

快速开始

  1. 获取您的 Apple 凭据（约 10 分钟，一次性）

  2. 生成您的密钥对（2 条命令）

  3. 添加到您的 MCP 客户端

  4. 开始聊天

Related MCP server: google-ads-mcp

设置

第 1 步 — 邀请 API 用户

由账户管理员在 searchads.apple.com 完成。

  1. 前往设置 → 用户管理 → 邀请用户

  2. 输入将使用 API 的人员的电子邮件

  3. 设置角色：

    • API 账户管理员 — 完全读写权限

    • API 账户只读 — 仅查看权限

  4. 发送邀请

API 用户必须是与管理员的不同 Apple ID。如果您是管理员，请使用第二个 Apple ID。

第 2 步 — 接受并复制您的凭据

由受邀用户完成。

  1. 接受电子邮件邀请并登录 searchads.apple.com

  2. 前往设置 → API 标签页

  3. 复制并保存以下三个值：

    • 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 行），然后：

  1. 前往 searchads.apple.com 上的设置 → API 标签页

  2. 粘贴到公钥字段

  3. 保存

第 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

设置以下环境变量：

变量

描述

ASA_CLIENT_ID

您的客户端 ID（以 SEARCHADS. 开头）

ASA_TEAM_ID

您的团队 ID（以 SEARCHADS. 开头）

ASA_KEY_ID

您的密钥 ID（UUID）

ASA_PRIVATE_KEY_PATH

您的 PKCS#8 私钥的绝对路径

ASA_ORG_ID

(可选) 默认使用的组织 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 个工具

类别

工具

组织

list_organizations, switch_organization, get_me_details

广告系列

list_campaigns, get_campaign_details, create_campaign, update_campaign, delete_campaign, get_campaign_report

广告组

list_ad_groups, get_ad_group, create_ad_group, update_ad_group, delete_ad_group, get_adgroup_report

关键词

get_keyword_report, list_targeting_keywords, get_targeting_keyword, add_targeting_keywords, update_targeting_keywords, delete_targeting_keywords, list_negative_keywords, get_negative_keyword, add_negative_keywords, update_negative_keywords, delete_negative_keywords

搜索词

get_search_term_report

广告

list_ads, get_ad, create_ad, update_ad, delete_ad, get_ad_report, find_ad_rejection_reasons

创意

list_creatives, get_creative, create_creative, list_product_pages, get_product_page_by_id

预算订单

list_budget_orders, get_budget_order, create_budget_order, update_budget_order

应用与地理

search_apps, get_app_details, get_app_eligibility, find_app_assets, search_geolocations

地理表现

get_geo_performance

展示份额

create_impression_share_report, get_impression_share_report_by_id, list_impression_share_reports

优化

get_campaign_snapshot, get_budget_analysis

资源

服务器提供 3 个资源：

URI

描述

apple-ads://countries

Apple Search Ads 支持的国家和地区

apple-ads://device-sizes

创意素材的应用预览设备尺寸

apple-ads://metrics-glossary

所有报告指标（CPA、CPT、TTR 等）的定义、公式和基准

提示

6 个内置工作流提示，用于指导常见任务：

提示

描述

campaign_health_check

综合广告系列分析 — 审查支出、转化、CPA 趋势并标记问题

keyword_optimization

关键词和搜索词优化工作流 — 发现浪费的支出和新的机会

new_campaign_setup

引导式新广告系列创建 — 逐步完成应用选择、结构、关键词和预算

budget_reallocation

跨广告系列预算分析 — 识别超支/支出不足并提出预算调整

creative_review

创意 A/B 审查 — 比较广告表现、标记拒绝、推荐优胜者

geo_expansion

地理扩展分析 — 对当前市场进行排名并识别要进入的新市场

"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

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • google-ads-mcp by googleads

    google-ads-mcpofficial

    googleads
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server that provides tools and resources for interacting with Google Ads API, enabling search, metadata retrieval, and account management through natural language.
    865
    Apache 2.0

  • Meta Ads MCP Server

    brmh
    F
    license
    Not graded
    quality
    D
    maintenance
    A comprehensive MCP server for managing and analyzing Meta Ads (Facebook/Instagram) with over 80 natural-language tools for AI agents like Claude Desktop.

  • mlg-meta-mcp

    iammalego
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP 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.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Appcircle MCP

    MCP server for Appcircle mobile CI/CD platform.

  • Shots

    Create App Store screenshots, icons, ASO copy, localization, and revisions via hosted MCP.

  • Vee3

    Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Happygallo/apple-ads-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server