Meta Ads Insights Macp

Meta Ads Insights MCP Server

HubSpot の取引データとの結合を標準でサポートする、Meta（Facebook）広告インサイトデータにアクセスするための Model Context Protocol（MCP）サーバーです。

機能

• 柔軟なフィルタリングと内訳指定で広告インサイトを取得
• キャンペーンと広告セットの管理
• 収益のアトリビューションに対応したモバイルプレースメントの追跡
• 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