SearchAds Manager 包含仅限 macOS 的本地 MCP 服务器，在 App 内运行，并复用账号设置中已配置的 Apple Search Ads 凭据。

它的功能

• 创建广告系列前，先发现所拥有的 App 和受支持的国家。
• 获取广告系列、广告组和关键词报表，无需编写自定义 API 脚本。
• 从 Codex 通过本地、经过身份验证的端点，创建、更新和删除广告系列、广告组及关键词。
• 在 App 运行期间，让连接保持在 Mac 本机内。

运行方式

1. 服务器仅绑定到 127.0.0.1。
2. 服务器仅在 macOS App 运行时可用。
3. 访问由生成的令牌保护，令牌存储在 App 设置中。
4. MCP 端点为 /mcp。
5. 健康检查端点位于 /health。

SearchAds Manager 中的设置

macOS 的设置界面包含 Codex MCP Server 卡片，其中提供：

1. 启用开关
2. 可配置的 TCP 端口
3. 自动生成的访问令牌
4. 包含身份验证信息的完整 MCP URL
5. 可直接运行的 Codex 命令
6. 本地监听器的状态反馈

可用的 MCP 工具

发现与元数据

• list_apps
• list_supported_countries

报表

• get_campaign_report
• get_adgroup_report
• get_keyword_report

广告系列管理

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

广告组管理

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

关键词管理

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

典型工作流程

1. 调用 list_apps，查找要推广的 App 的 adam_id。
2. 调用 list_supported_countries，确认有效的国家或地区代码。
3. 使用 get_campaign_report、get_adgroup_report 或 get_keyword_report 检查当前表现。
4. 使用 list_campaigns、list_adgroups 和 list_keywords 检查当前状态。
5. 采用小批量、范围明确的写入，以便理解错误，并在需要时撤销。

下一步

要将服务器添加到 Codex 并运行临时冒烟测试，请打开将 SearchAds Manager 连接到 Codex。