名称： microsoft-ads-mcp
描述： 通过 MCP 服务器创建和管理 Microsoft Advertising 广告系列（Bing Ads / DuckDuckGo Ads）——包括广告系列、广告组、关键词、广告和报告功能。
元数据： {"clawdbot":{"emoji":"📢","requires":{"commands":["mcporter"]},"homepage":"https://github.com/Duartemartins/microsoft-ads-mcp-server"}}

Microsoft Ads MCP 服务器

通过编程方式创建和管理 Microsoft Advertising 广告系列。此 MCP 服务器支持对 Bing 和 DuckDuckGo 搜索广告进行完整的广告系列管理。

为何选择 Microsoft Advertising？

• DuckDuckGo 集成 - Microsoft Advertising 为 DDG 搜索广告提供支持，触达注重隐私的用户。
• 更低的 CPC - 通常比 Google Ads 便宜 30-50%。
• Bing + Yahoo + AOL - 覆盖完整的 Microsoft 搜索网络。
• 从 Google 导入 - 轻松迁移现有广告系列。

设置

1. 安装 MCP 服务器

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. 开发者令牌：在 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，登录，复制重定向 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}'

# 创建自适应搜索广告
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"}'

# 检查状态并获取下载 URL
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

匹配类型

报告列

广告系列报告：CampaignName, Impressions, Clicks, Ctr, AverageCpc, Spend, Conversions, Revenue

关键词报告：Keyword, AdGroupName, CampaignName, Impressions, Clicks, Ctr, AverageCpc, Spend, Conversions, QualityScore

搜索查询报告：SearchQuery, Keyword, CampaignName, Impressions, Clicks, Spend, Conversions

地理报告：Country, State, City, CampaignName, Impressions, Clicks, Spend, Conversions

提示

1. 从暂停状态开始 - 广告系列默认创建为暂停状态。激活前请仔细检查。
2. 使用词组匹配 - 对于大多数关键词，词组匹配在覆盖面和相关性之间取得了良好平衡。
3. 使用多个标题 - 自适应搜索广告需要 3-15 个标题（每个 30 字符）和 2-4 个描述（每个 90 字符）。
4. 检查搜索查询 - 查看实际搜索词以寻找否定关键词。
5. 地理定位 - 利用地理报告按位置进行优化。

致谢

MCP 服务器：github.com/Duartemartins/microsoft-ads-mcp-server

基于 FastMCP 和 Bing Ads Python SDK 构建