Meta Ads Insights Macp

Meta Ads Insights MCP Server

用于访问 Meta（Facebook）广告洞察数据的 Model Context Protocol（MCP）服务，内置支持与 HubSpot 交易数据联接。

功能

• 灵活筛选数据并按不同维度细分，获取广告洞察
• 管理广告系列和广告组
• 跟踪移动端版位，以便进行收入归因
• 准备广告数据，以便与 HubSpot 交易数据联接
• 通过 MCP 配置设置访问令牌

设置

1. 安装依赖项：

npm install

2. 构建服务：

npm run build

3. 配置 Claude Desktop： 将服务配置添加到 Claude Desktop 配置文件中：

位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "meta-ads-insights": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "META_ACCESS_TOKEN": "your_meta_access_token_here",
        "META_AD_ACCOUNT_ID": "your_ad_account_id_without_act_prefix",
        "META_API_VERSION": "v19.0"
      }
    }
  }
}

4. 获取 Meta 访问令牌：

   • 前往 Meta for Developers
   • 创建一个应用，或使用现有应用
   • 生成具有 ads_read 权限的用户访问令牌
   • 用于生产环境时，请使用系统用户访问令牌

5. 查找广告账户 ID：

   • 前往 Meta Ads Manager
   • 账户 ID 位于 URL 中：act_1234567890（仅使用 1234567890）

可用工具

get_ad_insights

获取包含细分数据和筛选条件的广告效果数据。

使用示例：

Get mobile ad performance for the last 30 days with placement breakdown

get_campaigns

列出广告系列，并提供筛选选项。

get_adsets

列出广告组，可按广告系列筛选。

prepare_hubspot_join

通过多种策略准备广告数据，以便与 HubSpot 交易数据联接：

• date_range：匹配在归因窗口内创建的交易
• utm_params：匹配带有 UTM 参数的交易
• conversion_tracking：匹配带有 Facebook 点击 ID 的交易

工作流示例：

1. 获取移动端版位广告数据
2. 使用日期范围策略，准备与 HubSpot 数据联接
3. 使用准备好的数据查询 HubSpot，查找在归因窗口内创建的交易
4. 分析移动端广告与收入之间的相关性

用例示例

移动端广告收入归因

1. Get ads insights with device_platform and placement breakdowns
2. Filter for mobile placements
3. Prepare data for HubSpot join with 7-day attribution window
4. Query HubSpot deals created in that timeframe
5. Calculate ROI from mobile ad spend to deal revenue

广告系列效果分析

1. Get campaign insights for last 30 days
2. Break down by placement and device
3. Join with HubSpot deal data
4. Identify highest-converting campaign + placement combinations

数据联接策略

服务提供了一个 prepare_hubspot_join 工具，用于：

• 根据策略（UTM 参数、日期范围、点击 ID）添加联接键
• 计算归因窗口
• 标记移动端版位，以便筛选
• 提供 HubSpot 查询建议

这样便可将广告效果数据与 HubSpot 中跟踪的实际收入结果关联起来。

开发

# Development mode with auto-rebuild
npm run dev

# Build only
npm run build

# Run built server
npm start

故障排除

• 确保 Meta 访问令牌具有 ads_read 权限
• 确认广告账户 ID 正确（不含 “act_” 前缀）
• 检查 claude_desktop_config.json 中的绝对路径是否正确
• 更改配置后，重启 Claude Desktop# meta-insights-mcp