Meta Ads MCP

メタ広告MCP

Meta Ads APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このツールにより、AIモデルは標準化されたインターフェースを介してMeta広告キャンペーンにアクセスし、分析・管理できるようになります。これにより、LLMはパフォーマンスデータを取得し、広告クリエイティブを視覚化し、Facebook、Instagram、その他のMetaプラットフォーム向けの戦略的インサイトを提供できるようになります。

**免責事項：**これは非公式のサードパーティツールであり、Metaとは一切関係がなく、Metaの承認や提携も一切ありません。このプロジェクトは独立して管理されており、Metaの利用規約に従ってMetaの公開APIを使用しています。Meta、Facebook、Instagram、その他のMetaブランド名は、それぞれの所有者の商標です。

スクリーンショット: LLM を使用して広告のパフォーマンスを理解する:

クイックスタート

1. Metaで認証するには、 Pipeboardにサインアップしてください（または、独自のカスタムMetaアプリを設定することもできます）。
2. pipeboard.co/api-tokensで Pipeboard トークンを取得してください。
3. この構成を MCP クライアントに追加します。

これで完了です。お気に入りの MCP クライアントで Meta Ads MCP を使用できるようになりました。

注: Pipeboard 認証の代わりに独自の Meta Developer App を使用する場合は、手順についてはCUSTOM_META_APP.md を参照してください。

特徴

• AIを活用したキャンペーン分析：お気に入りのLLMがキャンペーンを分析し、パフォーマンスに関する実用的な洞察を提供します。
• 戦略的推奨事項: 広告費、ターゲティング、クリエイティブコンテンツの最適化に関するデータに基づいた提案を受け取ります
• 自動監視 対応の LLM にパフォーマンス メトリックを追跡してもらい、重要な変更があったら通知してもらいます。
• 予算の最適化: パフォーマンスの高い広告セットに予算を再配分するための推奨事項を取得します
• クリエイティブの改善: 広告コピー、画像、行動喚起に関するフィードバックを受け取る
• キャンペーン管理: キャンペーン、広告セット、広告の変更をリクエストします (すべての変更には明示的な確認が必要です)
• クロスプラットフォーム統合: Facebook、Instagram、およびすべてのMeta広告プラットフォームで動作します
• ユニバーサル LLM サポート: Claude Desktop、Cursor、Cherry Studio など、あらゆる MCP クライアントと互換性があります。
• シンプルな認証: 安全なOAuth認証による簡単なセットアップ
• クロスプラットフォームサポート：Windows、macOS、Linuxで動作

詳細設定

開発インストール

プロジェクトに貢献する場合、または直接実行する必要がある場合:

プライバシーとセキュリティ

Meta Ads MCP は、セキュリティのベストプラクティスに従います。

1. トークンはプラットフォーム固有の安全な場所にキャッシュされます。
   • Windows: %APPDATA%\meta-ads-mcp\token_cache.json
   • macOS: ~/Library/Application Support/meta-ads-mcp/token_cache.json
   • Linux: ~/.config/meta-ads-mcp/token_cache.json
2. 各コマンドにアクセス トークンを指定する必要はありません。アクセス トークンはキャッシュから自動的に取得されます。

テスト

LLMインターフェーステスト

Meta Ads MCP を LLM インターフェース (Claude など) と共に使用する場合:

1. PIPEBOARD_API_TOKEN環境変数が設定されていることを確認する
2. mcp_meta_ads_get_ad_accountsを呼び出してアカウントアクセスを確認します
3. mcp_meta_ads_get_account_infoで特定のアカウントの詳細を確認します

トラブルシューティング

認証の問題

認証の問題が発生した場合:

1. Pipeboard の設定を確認します。
   • PIPEBOARD_API_TOKENが正しく設定されていることを確認してください
   • Pipeboardダッシュボードでトークンを確認する
   • 新しいログインを強制してみます: python test_pipeboard_auth.py --force-login
2. LLM インターフェイスを使用する場合:
   • PIPEBOARD_API_TOKEN環境変数が設定されていることを確認する
   • コールバックサーバーが正常に動作していることを確認する

APIエラー

Meta API からエラーが発生した場合:

1. ユーザーが広告アカウントに対して適切な権限を持っていることを確認する
2. レート制限やその他の制限があるかどうかを確認する
3. Pipeboardトークンの有効期限が切れていないことを確認してください

ログの場所

ログ ファイルはプラットフォーム固有の場所に保存されます。

• macOS : ~/Library/Application Support/meta-ads-mcp/meta_ads_debug.log
• Windows : %APPDATA%\meta-ads-mcp\meta_ads_debug.log
• Linux : ~/.config/meta-ads-mcp/meta_ads_debug.log

構成

パイプボード認証

Meta Ads MCP を使用する最も簡単な方法は、Pipeboard 認証を使用することです。

1. Pipeboard.coにサインアップして API トークンを生成する
2. 環境変数を設定します。
   export PIPEBOARD_API_TOKEN=your_pipeboard_token
3. meta-ads-mcp を実行すると、認証が自動的に処理されます。

カーソルまたはクロードデスクトップでの使用

Claude と統合するには、これをclaude_desktop_config.jsonに追加するか、Cursor と統合するには~/.cursor/mcp.jsonに追加します。

利用可能なMCPツール

1. mcp_meta_ads_get_ad_accounts
   • ユーザーがアクセスできる広告アカウントを取得する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • user_id : メタユーザーIDまたは現在のユーザーの「me」
     • limit : 返されるアカウントの最大数（デフォルト: 10）
   • 返される値: アクセス可能な広告アカウントとその詳細のリスト
2. mcp_meta_ads_get_account_info
   • 特定の広告アカウントに関する詳細情報を取得する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
   • 戻り値: 指定されたアカウントの詳細情報
3. mcp_meta_ads_get_account_pages
   • Meta Adsアカウントに関連付けられたページを取得する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX) または現在のユーザーのページの場合は「me」
   • 戻り値: アカウントに関連付けられたページのリスト。広告の作成と管理に役立ちます。
4. mcp_meta_ads_get_campaigns
   • オプションのフィルタリングを使用してMeta Adsアカウントのキャンペーンを取得する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
     • limit : 返されるキャンペーンの最大数（デフォルト: 10）
     • status_filter : ステータスでフィルタリングします (すべて空にするか、「ACTIVE」、「PAUSED」などにします)
   • 返されるもの: 条件に一致するキャンペーンのリスト
5. mcp_meta_ads_get_campaign_details
   • 特定のキャンペーンの詳細情報を取得する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • campaign_id : Meta Ads キャンペーン ID
   • 返される値: 指定されたキャンペーンの詳細情報
6. mcp_meta_ads_create_campaign
   • Meta Adsアカウントで新しいキャンペーンを作成する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
     • name : キャンペーン名
     • objective : キャンペーンの目的 (認知度、トラフィック、エンゲージメントなど)
     • status : キャンペーンの初期ステータス (デフォルト: 一時停止)
     • special_ad_categories : 該当する場合の特別広告カテゴリのリスト
     • daily_budget : アカウント通貨での1日あたりの予算（セント単位）
     • lifetime_budget : アカウント通貨での生涯予算（セント単位）
   • 返品: 新しいキャンペーンの詳細の確認
7. mcp_meta_ads_get_adsets
   • オプションでキャンペーン別にフィルタリングできるMeta Adsアカウントの広告セットを取得します
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
     • limit : 返される広告セットの最大数（デフォルト: 10）
     • campaign_id : フィルタリングするオプションのキャンペーンID
   • 戻り値: 条件に一致する広告セットのリスト
8. mcp_meta_ads_get_adset_details
   • 特定の広告セットに関する詳細情報を取得する
   • 入力:
     • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
     • adset_id : Meta Ads 広告セット ID
   • 戻り値: 指定された広告セットの詳細情報
9. mcp_meta_ads_create_adset
   • Meta Adsアカウントで新しい広告セットを作成する
   • 入力:
     • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
     • campaign_id : この広告セットが属するMeta AdsキャンペーンID
     • name : 広告セット名
     • status : 広告セットの初期ステータス (デフォルト: 一時停止)
     • daily_budget : アカウント通貨での1日あたりの予算（セント単位）の文字列
     • lifetime_budget : アカウント通貨での生涯予算（セント単位）の文字列
     • targeting : ターゲティングの詳細（年齢、場所、興味など）
     • optimization_goal : コンバージョン最適化目標（例: 'LINK_CLICKS'）
     • billing_event : 課金方法（例: 「IMPRESSIONS」）
     • bid_amount : アカウント通貨での入札額（セント）
     • bid_strategy : 入札戦略（例: 'LOWEST_COST'）
     • start_time 、 end_time : オプションの開始/終了時刻（ISO 8601）
     • access_token (オプション): Meta API アクセストークン
   • 返品: 新しい広告セットの詳細の確認
10. mcp_meta_ads_get_ads

• オプションのフィルタリング機能を備えたMeta Adsアカウントの広告を取得する
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
  • limit : 返される広告の最大数（デフォルト: 10）
  • campaign_id : フィルタリングするオプションのキャンペーンID
  • adset_id : フィルタリングするオプションの広告セットID
• 戻り値: 条件に一致する広告のリスト

11. mcp_meta_ads_create_ad

• 既存のクリエイティブを使用して新しい広告を作成する
• 入力:
  • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
  • name : 広告名
  • adset_id : この広告が掲載される広告セットID
  • creative_id : 使用する既存のクリエイティブのID
  • status : 初期の広告ステータス (デフォルト: 一時停止)
  • bid_amount : 入札額（オプション）（セント単位）
  • tracking_specs : オプションの追跡仕様
  • access_token (オプション): Meta API アクセストークン
• 返品: 新しい広告の詳細の確認

12. mcp_meta_ads_get_ad_details

• 特定の広告の詳細情報を取得する
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • ad_id : メタ広告の広告ID
• 戻り値: 指定された広告の詳細情報

13. mcp_meta_ads_get_ad_creatives

• 特定の広告のクリエイティブの詳細を取得する
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • ad_id : メタ広告の広告ID
• 返されるもの: テキスト、画像、URL などのクリエイティブの詳細

14. mcp_meta_ads_create_ad_creative

• アップロードした画像ハッシュを使用して新しい広告クリエイティブを作成する
• 入力:
  • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
  • name : クリエイティブ名
  • image_hash : アップロードされた画像のハッシュ
  • page_id : 広告のFacebookページID
  • link_url : リンク先URL
  • message ：広告コピー/テキスト
  • headline : 広告の見出し
  • description : 広告の説明
  • call_to_action_type : CTAボタンの種類（例:「LEARN_MORE」）
  • instagram_actor_id : オプションのInstagramアカウントID
  • access_token (オプション): Meta API アクセストークン
• 返品: 新しいクリエイティブの詳細の確認

15. mcp_meta_ads_upload_ad_image

• Meta Adsクリエイティブで使用する画像をアップロードする
• 入力:
  • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
  • image_path : アップロードする画像ファイルへのパス
  • name : 画像の名前（オプション）
  • access_token (オプション): Meta API アクセストークン
• 戻り値: ハッシュを含む画像の詳細を含むJSONレスポンス

16. mcp_meta_ads_get_ad_image

• メタ広告画像をワンステップで取得、ダウンロード、視覚化
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • ad_id : メタ広告の広告ID
• 戻り値: 直接視覚的に分析できる広告画像

17. mcp_meta_ads_update_ad

• 新しい設定で広告を更新する
• 入力:
  • ad_id : メタ広告の広告ID
  • status : 広告のステータスを更新します (ACTIVE、PAUSED など)
  • bid_amount : アカウント通貨での入札額（USDの場合はセント）
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
• 返品: 更新された広告の詳細と確認リンクを含む確認

18. mcp_meta_ads_update_adset

• フリークエンシー キャップを含む新しい設定で広告セットを更新する
• 入力:
  • adset_id : Meta Ads 広告セット ID
  • frequency_control_specs : 周波数制御仕様のリスト
  • bid_strategy : 入札戦略（例: 'LOWEST_COST_WITH_BID_CAP'）
  • bid_amount : アカウント通貨での入札額（USDの場合はセント）
  • status : 広告セットのステータスを更新します (アクティブ、一時停止など)
  • targeting : targeting_automation を含むターゲティング仕様
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
• 返品: 更新された広告セットの詳細と確認リンクを含む確認

19. mcp_meta_ads_get_insights

• キャンペーン、広告セット、広告、またはアカウントのパフォーマンス分析情報を取得します
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • object_id : キャンペーン、広告セット、広告、またはアカウントのID
  • time_range : インサイトの時間範囲（デフォルト: 最大）
  • breakdown : オプションの内訳ディメンション（例: 年齢、性別、国）
  • level : 集約レベル（広告、広告セット、キャンペーン、アカウント）
• 戻り値: 指定されたオブジェクトのパフォーマンスメトリック

20. mcp_meta_ads_debug_image_download

• イメージのダウンロード問題をデバッグし、詳細な診断結果を報告します
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • url : テストする画像のURL（オプション）
  • ad_id : Meta Ads の広告 ID (オプション、URL が指定されていない場合に使用)
• 戻り値: 画像のダウンロード試行に関する診断情報

21. mcp_meta_ads_get_login_link

• Meta Ads認証用のクリック可能なログインリンクを取得する
• 入力:
  • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
• 戻り値: Meta認証用のクリック可能なリソースリンク

22. mcp_meta-ads_create_budget_schedule

• Meta Ads キャンペーンの予算スケジュールを作成します。
• 入力:
  • campaign_id : Meta Ads キャンペーン ID。
  • budget_value : 予算の増額額。
  • budget_value_type : 予算値のタイプ ("ABSOLUTE" または "MULTIPLIER")。
  • time_start : 需要が高い期間がいつ開始するかを示す Unix タイムスタンプ。
  • time_end : 需要の高い期間が終了する時期を示す Unix タイムスタンプ。
  • access_token (オプション): Meta API アクセス トークン。
• 戻り値: 作成された予算スケジュールの ID またはエラー メッセージを含む JSON 文字列。