Facebook Ads MCP Server

Facebook Ads MCP サーバー

🇨🇿 チェコ語版

Claude AI から Facebook 広告を直接管理するための MCP サーバーです。手動でトークンを探す必要はありません。Facebook に一度サインインすれば完了です。

機能

• キャンペーン管理（作成、更新、削除）
• 広告セットと個別の広告
• 分析とインサイト
• カスタムオーディエンスと類似オーディエンス
• ページ投稿
• トークンの自動管理（ページトークンは無期限です）

インストール

必要条件

• Node.js 18+
• Claude Desktop

1. リポジトリをクローンする

git clone https://github.com/Tisik79/MCP-Facebook.git
cd MCP-Facebook
npm install
npm run build

2. Claude Desktop に追加する

Claude Desktop の設定ファイルを開きます。

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

次を追加します。

{
  "mcpServers": {
    "facebook-ads": {
      "command": "node",
      "args": ["/PATH/TO/MCP-Facebook/dist/index.js"]
    }
  }
}

3. 初回起動 — 5 分で完了するセットアップ

初回起動時にウィザードが表示され、独自の Facebook App の作成を案内します。

Steps:
  1. Click "Create App"
  2. Choose type: "Business"
  3. Enter any name (e.g. "My Ads")
  4. After creation, go to Settings → Basic
  5. Copy the App ID and App Secret
  6. Add the "Facebook Login" product and set:
     Valid OAuth Redirect URIs: http://localhost:3456/auth/callback
  7. In Basic settings, add "localhost" to App Domains

App ID と Secret を入力すると、ブラウザーが自動的に開きます → Facebook にサインインします → 完了です。

再ログイン／ページの追加

node dist/index.js login

Claude での使用方法

"Show my active campaigns"
"Create a campaign for MyBrand with a $20 daily budget"
"How did my ads perform last month?"
"Post an update to page XY"

利用可能なツール

ツール	説明
connect_facebook_account / set_facebook_token	OAuth でサインインする／Graph API Explorer のトークンを保存する
list_connected_accounts / set_active_account	接続済みのページとアカウントを表示する／アクティブなものを切り替える
facebook_setup_help	接続手順のガイド
get_campaigns	キャンペーンを一覧表示する
create_campaign	新しいキャンペーンを作成する
update_campaign	キャンペーンを更新する（bidStrategy を含む）— 書き込み後に読み取り
get_campaign_details	キャンペーンの詳細（予算、bid_strategy、本日の消化額）
delete_campaign	キャンペーンを削除する
get_campaign_insights	キャンペーンの分析データ
get_adset_insights / get_ad_insights	広告セット／広告レベルの分析データ
get_adsets	広告セットを一覧表示する
create_ad_set	広告セットを作成する（リード項目 promotedObject / destinationType を含む）
update_adset	広告セットを更新する（名前／ステータス）— 実際に書き込み、書き込み後に読み取って検証
get_ads	広告を一覧表示する（adSetId/campaignId エッジとステータスで絞り込み）
get_ad	広告の詳細（クリエイティブを含む：リンク、CTA、コピー、動画／画像）
upload_ad_media	画像（image_hash）または動画（video_id）をアップロードする
create_adcreative	object_story_spec からクリエイティブを作成する
create_ad	広告を作成する（デフォルトは一時停止）
update_ad	広告を更新する（名前／ステータス／クリエイティブ）— 書き込み後に読み取り
delete_ad	広告を削除する
create_lead_form	ページにインスタントリードフォームを作成する
get_lead_forms	リードフォームを一覧表示する（id、name、status、leads_count）
get_pixels	promoted_object 用のアカウントピクセル（id、name）
create_pixel / update_pixel / get_pixel	ピクセル管理（last_fired_time を含む詳細）
get_pixel_stats	ピクセルイベントの統計情報（イベントが送信されていることを検証）
search_interests / get_interest_suggestions	ターゲティング用の興味・関心の検索と候補
search_behaviors	ターゲティング用の行動カテゴリ
search_geo_locations	targeting.geo_locations 用の地域キー（地域／市区町村／郵便番号）
estimate_audience_size	指定したターゲティング仕様のオーディエンスサイズを推定する
send_conversion_event / send_conversion_events_batch	Conversions API — サーバーサイドイベント（個人を特定できる情報を自動で SHA-256 ハッシュ化）
get_custom_conversions / get_custom_conversion	カスタムコンバージョンの一覧／詳細
create_custom_conversion / update_custom_conversion / delete_custom_conversion	カスタムコンバージョン（リードキャンペーン用の custom_conversion_id）
get_offline_conversion_sets / create_offline_conversion_set / upload_offline_conversions	CRM からのオフラインコンバージョン
update_adcreative	クリエイティブを更新する（名前／ステータス — コンテンツは変更不可）
get_audiences	カスタムオーディエンス
create_custom_audience	オーディエンスを作成する
create_lookalike_audience	類似オーディエンス
create_post	ページ投稿
create_video_post	動画のページ投稿（再開可能なアップロード、デフォルトでは未公開）

ターゲティング／コンバージョン用ツールセットの範囲は、 Draivix/aidvertaiser（David Strejc、MIT）を参考にしました — ありがとうございます！

リードキャンペーン（OUTCOME_LEADS）

リードの収集方法は2つあります。どちらも広告セットに promotedObject と destinationType が必要です。

• ウェブサイトコンバージョン — optimizationGoal=OFFSITE_CONVERSIONS、destinationType=WEBSITE、 promotedObject={ pixel_id, custom_event_type: "LEAD" }（get_pixels でPixel IDを確認します）。
• インスタントフォーム — optimizationGoal=LEAD_GENERATION、destinationType=ON_AD、 promotedObject={ page_id }、call_to_action.value.lead_gen_form_id を含むクリエイティブ （create_lead_form でフォームを作成します）。

promotedObject と destinationType がない場合、Metaは「Invalid parameter」を返します。キャンペーンレベルの予算（CBO）を使用するアカウントでは、広告セットに予算を設定しないでください。キャンペーンから引き継がれます。キャンペーンで上限入札戦略（LOWEST_COST_WITH_BID_CAP）を使用する場合、広告セットには bidAmount が必要です。それ以外の場合は、キャンペーンの bidStrategy=LOWEST_COST_WITHOUT_CAP を設定します。

ライセンス

MIT