Microsoft Ads MCP 服务器

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

为何选择 Microsoft Advertising？

• DuckDuckGo 集成- Microsoft Advertising 为 DDG 搜索广告提供支持，触达注重隐私的用户
• 更低的每次点击费用- 通常比 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
# Open URL in browser, sign in, copy redirect URL
mcporter call microsoft-ads.complete_auth '{"redirect_url": "https://login.microsoftonline.com/common/oauth2/nativeclient?code=..."}'

可用工具

账户管理

mcporter call microsoft-ads.search_accounts

广告系列操作

# List campaigns
mcporter call microsoft-ads.get_campaigns

# Create campaign (starts paused for safety)
mcporter call microsoft-ads.create_campaign '{"name": "My Campaign", "daily_budget": 20}'

# Activate or pause
mcporter call microsoft-ads.update_campaign_status '{"campaign_id": 123456, "status": "Active"}'

广告组

# List ad groups
mcporter call microsoft-ads.get_ad_groups '{"campaign_id": 123456}'

# Create ad group
mcporter call microsoft-ads.create_ad_group '{"campaign_id": 123456, "name": "Product Keywords", "cpc_bid": 1.50}'

关键词

# List keywords
mcporter call microsoft-ads.get_keywords '{"ad_group_id": 789012}'

# Add keywords (Broad, Phrase, or Exact match)
mcporter call microsoft-ads.add_keywords '{"ad_group_id": 789012, "keywords": "buy widgets, widget store", "match_type": "Phrase", "default_bid": 1.25}'

广告

# List ads
mcporter call microsoft-ads.get_ads '{"ad_group_id": 789012}'

# Create 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."
}'

报告

# Submit report request
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"}'

# Check status and get download URL
mcporter call microsoft-ads.poll_report_status

其他

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

完整工作流示例

# 1. Check account
mcporter call microsoft-ads.search_accounts

# 2. Create campaign
mcporter call microsoft-ads.create_campaign '{"name": "PopaDex - DDG Search", "daily_budget": 15}'
# Returns: Campaign ID 123456

# 3. Create ad group
mcporter call microsoft-ads.create_ad_group '{"campaign_id": 123456, "name": "Privacy Keywords", "cpc_bid": 0.75}'
# Returns: Ad Group ID 789012

# 4. Add keywords
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. Create ad
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. Activate campaign
mcporter call microsoft-ads.update_campaign_status '{"campaign_id": 123456, "status": "Active"}'

# 7. Check performance after a few days
mcporter call microsoft-ads.submit_campaign_performance_report '{"date_range": "LastWeek"}'
mcporter call microsoft-ads.poll_report_status

匹配类型

报告列

广告系列报告: 广告系列名称、展示次数、点击次数、点击率、平均每次点击费用、花费、转化次数、收入

关键词报告: 关键词、广告组名称、广告系列名称、展示次数、点击次数、点击率、平均每次点击费用、花费、转化次数、质量得分

搜索查询报告: 搜索查询、关键词、广告系列名称、展示次数、点击次数、花费、转化次数

地理区域报告: 国家/地区、州/省、城市、广告系列名称、展示次数、点击次数、花费、转化次数

提示

1. 开始时暂停- 广告系列默认创建为暂停状态。激活前请先审核。
2. 使用短语匹配- 对大多数关键词而言，能在覆盖范围和相关性之间取得良好平衡。
3. 多个标题- RSA广告需要3-15条标题（每条30字符以内）和2-4条描述（每条90字符以内）。
4. 检查搜索查询- 查看实际搜索词以找出否定关键词。
5. 地理定位- 使用地理报告按位置进行优化。

致谢

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

构建工具FastMCP和Bing Ads Python SDK