什么是 Microsoft Ads MCP 服务端？

Microsoft Ads MCP 服务端是一个强大的工具，旨在通过模型上下文协议 (MCP) 与 Microsoft Advertising API 进行交互。作为 Openclaw Skills 生态系统的一部分，它使开发人员能够在 Microsoft 搜索网络（包括 Bing、Yahoo、AOL 和 DuckDuckGo）上创建、管理和优化搜索引擎营销广告系列。

该技能弥补了手动仪表板管理与自动化、编程化广告运营之间的差距。它允许无缝处理高成交量的广告账户，同时提供更低的 CPC 机会，并触达 DuckDuckGo 等平台上独特的、注重隐私的受众。通过使用此服务端，团队可以将广告工作流直接集成到其 AI 驱动的开发或营销自动化技术栈中。

下载入口:https://github.com/openclaw/skills/tree/main/skills/duartemartins/microsoft-ads-mcp

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Microsoft Ads MCP 服务端 应用场景

• 自动化在 Bing 和 DuckDuckGo 上创建搜索广告系列，以触达特定受众。
• 简化从 Google Ads 到 Microsoft Advertising 的高效关键词和广告文案迁移。
• 使用 CLI 工具跨多个账户扩展广告组管理和关键词竞价策略。
• 生成并下载详细的效果报告，以便输入自定义数据分析流水线。
• 以编程方式管理自适应搜索广告 (RSA)，大规模测试标题和描述。

1. 服务端使用开发者令牌 (Developer Token) 和 Azure AD 客户端 ID 连接到 Microsoft Advertising API。
2. 用户发起 OAuth 身份验证流程，将他们的 Microsoft Ads 账户安全地链接到该技能。
3. 通过 MCP 接口发出命令，以定义广告系列结构、预算和定位参数。
4. 服务端处理这些请求，以创建或更新广告组、关键词和创意资产等实体。
5. 集成的报告工具允许用户提交报告请求并轮询完成状态，以检索点击率 (CTR)、消耗和转化等性能指标。

Microsoft Ads MCP 服务端 配置指南

按照以下步骤将此技能集成到您的工作流中：

1. 安装：

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

2. 配置：将以下内容添加到您的 ~/.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"
      }
    }
  }
}

3. 身份验证：通过您的 MCP 客户端执行认证命令：

mcporter call microsoft-ads.get_auth_url
# 登录并复制重定向 URL
mcporter call microsoft-ads.complete_auth '{"redirect_url": "YOUR_REDIRECT_URL"}'

Microsoft Ads MCP 服务端 数据架构与分类体系

该技能将广告数据组织成与标准营销分类法兼容的层级结构：

name: microsoft-ads-mcp
description: Create and manage Microsoft Advertising campaigns (Bing Ads / DuckDuckGo Ads) via MCP server - campaigns, ad groups, keywords, ads, and reporting
metadata: {"clawdbot":{"emoji":"??","requires":{"commands":["mcporter"]},"homepage":"https://github.com/Duartemartins/microsoft-ads-mcp-server"}}

Microsoft Ads MCP Server

Create and manage Microsoft Advertising campaigns programmatically. This MCP server enables full campaign management for Bing and DuckDuckGo search ads.

Why Microsoft Advertising?

• DuckDuckGo Integration - Microsoft Advertising powers DDG search ads, reaching privacy-conscious users
• Lower CPCs - Often 30-50% cheaper than Google Ads
• Bing + Yahoo + AOL - Access to the full Microsoft Search Network
• Import from Google - Easy migration of existing campaigns

Setup

1. Install the MCP server

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

2. Get credentials

1. Microsoft Ads Account: Sign up at ads.microsoft.com
2. Developer Token: Apply at developers.ads.microsoft.com
3. Azure AD App: Create at portal.azure.com with redirect URI https://login.microsoftonline.com/common/oauth2/nativeclient

3. Configure mcporter

Add to ~/.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. Authenticate

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

Available Tools

Account Management

mcporter call microsoft-ads.search_accounts

Campaign Operations

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

Ad Groups

# 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}'

Keywords

# 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}'

Ads

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

Reporting

# 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

Other

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

Complete Workflow Example

# 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

Match Types

Report Columns

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

Tips

1. Start paused - Campaigns are created paused by default. Review before activating.
2. Use Phrase match - Good balance between reach and relevance for most keywords.
3. Multiple headlines - RSAs need 3-15 headlines (30 chars each) and 2-4 descriptions (90 chars each).
4. Check search queries - Review actual search terms to find negative keywords.
5. Geographic targeting - Use geo reports to optimize by location.

Credits

MCP Server: github.com/Duartemartins/microsoft-ads-mcp-server

Built with FastMCP and the Bing Ads Python SDK