Microsoft Ads MCP Server

以编程方式创建和管理 Microsoft Advertising 广告系列。该 MCP Server 支持对 Bing 和 DuckDuckGo 搜索广告的完整广告系列管理。

为何选择 Microsoft Advertising？

• DuckDuckGo 集成 — Microsoft Advertising 为 DDG 搜索广告提供支持，触达注重隐私的用户群体
• 更低的单次点击费用（CPC） — 通常比 Google Ads 便宜 30–50%
• Bing + Yahoo + AOL — 接入完整的 Microsoft Search Network
• 从 Google 导入 — 可轻松迁移现有广告系列

安装与配置

1. 安装 MCP Server

git clone https://github.com/Duartemartins/microsoft-ads-mcp-server.git
cd microsoft-ads-mcp-server
pip install -r requirements.txt

2. 获取凭证

1. Microsoft Ads 账户：在 ads.microsoft.com 注册
2. 开发者令牌（Developer Token）：在 developers.ads.microsoft.com 申请
3. Azure AD 应用：在 portal.azure.com 创建，重定向 URI 设置为 https://login.microsoftonline.com/common/oauth2/nativeclient

3. 配置 mcporter

向 ~/.mcporter/mcporter.json 中添加以下内容：

{
  "mcpServers": {
    "microsoft-ads": {
      "command": "python3",
      "args": ["/path/to/microsoft-ads-mcp-server/server.py"],
      "type": "stdio",
      "env": {
        "MICROSOFT_ADS_DEVELOPER_TOKEN": "your_token",
        "MICROSOFT_ADS_CLIENT_ID": "your_azure_app_client_id"
      }
    }
  }
}

4. 认证

mcporter call microsoft-ads.get_auth_url
# 在浏览器中打开返回的 URL，登录后复制重定向地址
mcporter call microsoft-ads.complete_auth '{"redirect_url": "https://login.microsoftonline.com/common/oauth2/nativeclient?code=..."}'

可用工具

账户管理

mcporter call microsoft-ads.search_accounts

广告系列操作

# 列出广告系列
mcporter call microsoft-ads.get_campaigns

# 创建广告系列（默认暂停，确保安全）
mcporter call microsoft-ads.create_campaign '{"name": "My Campaign", "daily_budget": 20}'

# 启用或暂停广告系列
mcporter call microsoft-ads.update_campaign_status '{"campaign_id": 123456, "status": "Active"}'

广告组

# 列出广告组
mcporter call microsoft-ads.get_ad_groups '{"campaign_id": 123456}'

# 创建广告组
mcporter call microsoft-ads.create_ad_group '{"campaign_id": 123456, "name": "Product Keywords", "cpc_bid": 1.50}'

关键词

# 列出关键词
mcporter call microsoft-ads.get_keywords '{"ad_group_id": 789012}'

# 添加关键词（支持广泛匹配、短语匹配或完全匹配）
mcporter call microsoft-ads.add_keywords '{"ad_group_id": 789012, "keywords": "buy widgets, widget store", "match_type": "Phrase", "default_bid": 1.25}'

广告

# 列出广告
mcporter call microsoft-ads.get_ads '{"ad_group_id": 789012}'

# 创建响应式搜索广告（Responsive Search Ad）
mcporter call microsoft-ads.create_responsive_search_ad '{
  "ad_group_id": 789012,
  "final_url": "https://example.com/widgets",
  "headlines": "Buy Widgets Online|Best Widget Store|Free Shipping",
  "descriptions": "Shop our selection. Free shipping over $50.|Quality widgets at great prices."
}'

报表

# 提交报表请求
mcporter call microsoft-ads.submit_campaign_performance_report '{"date_range": "LastWeek"}'
mcporter call microsoft-ads.submit_keyword_performance_report '{"date_range": "LastMonth"}'
mcporter call microsoft-ads.submit_search_query_report '{"date_range": "LastWeek"}'
mcporter call microsoft-ads.submit_geographic_report '{"date_range": "LastMonth"}'

# 查询报表状态并获取下载链接
mcporter call microsoft-ads.poll_report_status

其他功能

mcporter call microsoft-ads.get_budgets
mcporter call microsoft-ads.get_labels

完整工作流示例

# 1. 检查账户
mcporter call microsoft-ads.search_accounts

# 2. 创建广告系列
mcporter call microsoft-ads.create_campaign '{"name": "PopaDex - DDG Search", "daily_budget": 15}'
# 返回：广告系列 ID 123456

# 3. 创建广告组
mcporter call microsoft-ads.create_ad_group '{"campaign_id": 123456, "name": "Privacy Keywords", "cpc_bid": 0.75}'
# 返回：广告组 ID 789012

# 4. 添加关键词
mcporter call microsoft-ads.add_keywords '{
  "ad_group_id": 789012,
  "keywords": "privacy search engine, private browsing, anonymous search",
  "match_type": "Phrase",
  "default_bid": 0.60
}'

# 5. 创建广告
mcporter call microsoft-ads.create_responsive_search_ad '{
  "ad_group_id": 789012,
  "final_url": "https://popadex.com",
  "headlines": "PopaDex Private Search|Search Without Tracking|Privacy-First Search Engine",
  "descriptions": "Search the web without being tracked. No ads, no profiling.|Your searches stay private. Try PopaDex today."
}'

# 6. 启用广告系列
mcporter call microsoft-ads.update_campaign_status '{"campaign_id": 123456, "status": "Active"}'

# 7. 数日后查看效果
mcporter call microsoft-ads.submit_campaign_performance_report '{"date_range": "LastWeek"}'
mcporter call microsoft-ads.poll_report_status

匹配类型

报表字段说明

广告系列报表（Campaign Reports）：CampaignName（广告系列名称）、Impressions（展现量）、Clicks（点击量）、Ctr（点击率）、AverageCpc（平均每次点击费用）、Spend（花费）、Conversions（转化次数）、Revenue（收入）

关键词报表（Keyword Reports）：Keyword（关键词）、AdGroupName（广告组名称）、CampaignName（广告系列名称）、Impressions（展现量）、Clicks（点击量）、Ctr（点击率）、AverageCpc（平均每次点击费用）、Spend（花费）、Conversions（转化次数）、QualityScore（质量得分）

搜索词报表（Search Query Reports）：SearchQuery（搜索词）、Keyword（关键词）、CampaignName（广告系列名称）、Impressions（展现量）、Clicks（点击量）、Spend（花费）、Conversions（转化次数）

地域报表（Geographic Reports）：Country（国家）、State（州/省）、City（城市）、CampaignName（广告系列名称）、Impressions（展现量）、Clicks（点击量）、Spend（花费）、Conversions（转化次数）

使用建议

1. 默认暂停启动 — 所有广告系列默认创建为暂停状态，请审核无误后再启用。
2. 优先使用短语匹配 — 对大多数关键词而言，短语匹配在覆盖面与相关性之间提供了良好平衡。
3. 设置多个标题行 — 响应式搜索广告（RSA）需提供 3–15 个标题（每个最多 30 字符）及 2–4 个描述（每个最多 90 字符）。
4. 定期分析搜索词 — 查看实际触发广告的搜索词，识别并添加否定关键词。
5. 优化地域定位 — 利用地域报表数据，按国家、州/省或城市层级优化投放策略。

致谢

MCP Server 项目地址：github.com/Duartemartins/microsoft-ads-mcp-server

基于 FastMCP 与 Bing Ads Python SDK 构建