Skip to main content
Glama
Sign In
enesjakozh

Meta Ads MCP

by pipeboard-co
Verified
GitHub
Python
Apache 2.0
7
  • Apple
  • Linux
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for managing and analyzing Facebook advertising campaigns, including performance metrics, campaign creation, and creative assessment.

  • Offers functionality to access, analyze and manage Instagram advertising campaigns through Meta's advertising platform.

  • Enables access to Meta's advertising APIs, allowing retrieval of ad performance data, campaign management, budget optimization, and viewing ad creatives across Meta platforms.

メタ広告MCP

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

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

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

特徴

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

インストール

uvの使用（推奨）

uvを使用する場合、特別なインストールは必要ありません。uvxを使用してmeta-ads-mcpを直接実行できます。

# RECOMMENDED: Use with Pipeboard authentication export PIPEBOARD_API_TOKEN=your_pipeboard_token # Get your token at https://pipeboard.co uvx meta-ads-mcp # Alternative: Use with direct Meta authentication uvx meta-ads-mcp --app-id YOUR_META_ADS_APP_ID

パッケージをインストールする場合:

uv pip install meta-ads-mcp

開発の場合（リポジトリをクローンした場合）：

# From the repository root uv pip install -e .

pipの使用

あるいは、pip 経由で meta-ads-mcp をインストールすることもできます。

pip install meta-ads-mcp

インストール後は次のように実行できます。

# RECOMMENDED: Use with Pipeboard authentication export PIPEBOARD_API_TOKEN=your_pipeboard_token # Get your token at https://pipeboard.co python -m meta_ads_mcp # Alternative: Use with direct Meta authentication python -m meta_ads_mcp --app-id YOUR_META_ADS_APP_ID

構成

Pipeboard 認証のクイック スタート (推奨)

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

  1. Pipeboard.coにサインアップして API トークンを生成します - https://pipeboard.coで無料トークンを入手してください
  2. 環境変数を設定します。
    export PIPEBOARD_API_TOKEN=your_pipeboard_token # Token obtainable via https://pipeboard.co
  3. Meta Developer App をセットアップせずに meta-ads-mcp を実行します。
    uvx meta-ads-mcp

この方法では、トークンの有効期間が長くなり（60 日間）、セットアップが簡素化され、トークンが自動的に更新されます。

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

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

"mcpServers": { "meta-ads": { "command": "uvx", "args": ["meta-ads-mcp"], "env": { "PIPEBOARD_API_TOKEN": "your_pipeboard_token" // Token obtainable via https://pipeboard.co } } }

または、直接のメタ認証（独自の Facebook アプリを使用）を希望する場合:

"mcpServers": { "meta-ads": { "command": "uvx", "args": ["meta-ads-mcp", "--app-id", "YOUR_META_ADS_APP_ID"] } }

利用可能な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_campaigns
    • オプションのフィルタリングを使用してMeta Adsアカウントのキャンペーンを取得する
    • 入力:
      • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
      • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
      • limit : 返されるキャンペーンの最大数（デフォルト: 10）
      • status_filter : ステータスでフィルタリングします (すべて空にするか、「ACTIVE」、「PAUSED」などにします)
    • 返されるもの: 条件に一致するキャンペーンのリスト
  4. mcp_meta_ads_get_campaign_details
    • 特定のキャンペーンの詳細情報を取得する
    • 入力:
      • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
      • campaign_id : Meta Ads キャンペーン ID
    • 返される値: 指定されたキャンペーンの詳細情報
  5. 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 : アカウント通貨での生涯予算（セント単位）
    • 返品: 新しいキャンペーンの詳細の確認
  6. mcp_meta_ads_get_adsets
    • オプションでキャンペーン別にフィルタリングできるMeta Adsアカウントの広告セットを取得します
    • 入力:
      • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
      • account_id : Meta Ads アカウント ID (形式: act_XXXXXXXXX)
      • limit : 返される広告セットの最大数（デフォルト: 10）
      • campaign_id : フィルタリングするオプションのキャンペーンID
    • 戻り値: 条件に一致する広告セットのリスト
  7. mcp_meta_ads_get_adset_details
    • 特定の広告セットに関する詳細情報を取得する
    • 入力:
      • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
      • adset_id : Meta Ads 広告セット ID
    • 戻り値: 指定された広告セットの詳細情報
  8. 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
    • 戻り値: 条件に一致する広告のリスト
  9. mcp_meta_ads_get_ad_details
    • 特定の広告の詳細情報を取得する
    • 入力:
      • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
      • ad_id : メタ広告の広告ID
    • 戻り値: 指定された広告の詳細情報
  10. mcp_meta_ads_get_ad_creatives
  • 特定の広告のクリエイティブの詳細を取得する
  • 入力:
    • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
    • ad_id : メタ広告の広告ID
  • 返されるもの: テキスト、画像、URL などのクリエイティブの詳細
  1. mcp_meta_ads_get_ad_image
  • メタ広告画像をワンステップで取得、ダウンロード、視覚化
  • 入力:
    • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
    • ad_id : メタ広告の広告ID
  • 戻り値: 直接視覚的に分析できる広告画像
  1. mcp_meta_ads_update_ad
  • 新しい設定で広告を更新する
  • 入力:
    • ad_id : メタ広告の広告ID
    • status : 広告のステータスを更新します (ACTIVE、PAUSED など)
    • bid_amount : アカウント通貨での入札額（USDの場合はセント）
    • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • 返品: 更新された広告の詳細と確認リンクを含む確認
  1. 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 アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • 返品: 更新された広告セットの詳細と確認リンクを含む確認
  1. mcp_meta_ads_get_insights
  • キャンペーン、広告セット、広告、またはアカウントのパフォーマンス分析情報を取得します
  • 入力:
    • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
    • object_id : キャンペーン、広告セット、広告、またはアカウントのID
    • time_range : インサイトの時間範囲（デフォルト: 最大）
    • breakdown : オプションの内訳ディメンション（例: 年齢、性別、国）
    • level : 集約レベル（広告、広告セット、キャンペーン、アカウント）
  • 戻り値: 指定されたオブジェクトのパフォーマンスメトリック
  1. mcp_meta_ads_debug_image_download
  • イメージのダウンロード問題をデバッグし、詳細な診断結果を報告します
  • 入力:
    • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
    • url : テストする画像のURL（オプション）
    • ad_id : Meta Ads 広告 ID (オプション、URL が指定されていない場合に使用)
  • 戻り値: 画像のダウンロード試行に関する診断情報
  1. mcp_meta_ads_get_login_link
  • Meta Ads認証用のクリック可能なログインリンクを取得する
  • 注: この方法は、ご自身のFacebookアプリを使用している場合にのみ使用してください。Pipeboard認証（推奨）を使用している場合は、代わりにPIPEBOARD_API_TOKEN環境変数を設定してください（トークンはhttps://pipeboard.coから取得できます）。
  • 入力:
    • access_token (オプション): Meta API アクセス トークン (指定されていない場合はキャッシュされたトークンが使用されます)
  • 戻り値: Meta認証用のクリック可能なリソースリンク

Meta Developerアプリを作成する

MCP サーバーを使用する前に、Meta Developer App を設定する必要があります。

  1. 開発者向けMetaにアクセスして新しいアプリを作成します
  2. 「コンシューマー」アプリタイプを選択します
  3. アプリ設定で「マーケティングAPI」製品を追加します
  4. アプリの OAuth リダイレクト URI にhttp://localhost:8888/callbackを含めるように設定します。
  5. MCPで使用するためにアプリID（クライアントID）をメモしてください

認証

Meta Ads MCP は、次の 2 つの認証方法をサポートしています。

1. Pipeboard 認証（推奨 ⭐）

この方法では、 Pipeboard.coを使用して Meta API 認証を管理し、より長い有効期間のトークンと簡素化されたフローを提供します。

  1. Pipeboardトークンを取得する: https://pipeboard.coにサインアップして無料のAPIトークンを生成します
  2. トークンを使用してPIPEBOARD_API_TOKEN環境変数を設定します。
    export PIPEBOARD_API_TOKEN=your_pipeboard_token
  3. Meta Ads MCP を通常どおり実行すると、Pipeboard 認証が自動的に検出され、使用されます。
    uvx meta-ads-mcp
  4. 初めてコマンドを実行すると、Metaで認証するためのログインURLが提供されます。

Pipeboard 認証の利点:

  • ✅ より長い有効期限のトークン（60日間）
  • ✅ Meta Developer Appを設定する必要はありません
  • ✅ APIトークンだけで簡単にセットアップできます
  • ✅ トークンの自動更新

Pipeboard 認証フローをテストするには:

python test_pipeboard_auth.py --api-token YOUR_PIPEBOARD_TOKEN

2. ダイレクトメタOAuth（レガシー）

デスクトップアプリ向けに設計された従来のOAuth 2.0フロー。この方法は、Pipeboardではなく独自のFacebookアプリを使用している場合にのみ使用してください。

認証時には次のようになります。

  1. マシン上でローカルコールバックサーバーを起動します
  2. Metaで認証するにはブラウザウィンドウを開きます
  3. アプリの承認を求める
  4. トークンを抽出して安全に保管するためにローカルサーバーにリダイレクトします

この方法では、まずMeta Developer App を作成する必要があります。

トラブルシューティングとログ

Meta Ads MCP には、問題のトラブルシューティングに役立つ包括的なログ システムが含まれています。

ログの場所

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

  • 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

よくある問題

認証の問題

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

  1. 推奨: Pipeboard 認証を使用する
    • export PIPEBOARD_API_TOKEN=your_tokenを設定して再試行してください
    • これにより、トークンの寿命が長くなり、信頼性が向上します。
    • Pipeboardダッシュボードでトークンを確認する
  2. アプリ ID の問題 (直接認証を使用している場合) の場合: (#200) Provide valid app IDなどのエラーが発生した場合は、以下を確認してください。
    • Meta Developer Appが正しく設定されていることを確認してください
    • 次のいずれかの方法を使用して、正しいアプリ ID を渡していることを確認します。
      • META_APP_ID環境変数を設定します: export META_APP_ID=your_app_id
      • コマンドライン引数として渡します: meta-ads-mcp --app-id your_app_id

APIエラー

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

  1. アプリにマーケティング API 製品が追加されていることを確認します
  2. ユーザーが広告アカウントに対して適切な権限を持っていることを確認する
  3. アプリにレート制限やその他の制限がないか確認する

デバッグコマンド

特定の画像のダウンロードの問題については、組み込みの診断ツールを使用します。

# Using direct tool call mcp_meta_ads_debug_image_download(ad_id="your_ad_id")

これにより、ダウンロードプロセスと潜在的な問題に関する詳細な情報が提供されます。

異なるアプリIDで実行する

目的に応じて異なる Meta App ID を使用する必要がある場合:

# Using environment variable export META_APP_ID=your_app_id uvx meta-ads-mcp # Or using command line argument uvx meta-ads-mcp --app-id=your_app_id

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

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

  1. トークンはプラットフォーム固有の安全な場所にキャッシュされます。
    • Windows: %APPDATA%\meta-ads-mcp\token_cache.jsonまたは%APPDATA%\meta-ads-mcp\pipeboard_token_cache.json
    • macOS: ~/Library/Application Support/meta-ads-mcp/token_cache.jsonまたは~/Library/Application Support/meta-ads-mcp/pipeboard_token_cache.json
    • Linux: ~/.config/meta-ads-mcp/token_cache.jsonまたは~/.config/meta-ads-mcp/pipeboard_token_cache.json
  2. 各コマンドにアクセス トークンを指定する必要はありません。アクセス トークンはキャッシュから自動的に取得されます。
  3. 引数として渡す代わりに、次の環境変数を設定できます。
    • META_APP_ID : Meta App ID (クライアントID) - 直接OAuth方式の場合
    • PIPEBOARD_API_TOKEN : Pipeboard APIトークン - Pipeboard認証方法用

テスト

CLIテスト

テスト スクリプトを実行して、認証と基本機能を検証します。

python test_meta_ads_auth.py --app-id YOUR_APP_ID

キャッシュされたトークンが存在する場合でも、新しい認証を強制するには、 --force-loginフラグを使用します。

python test_meta_ads_auth.py --app-id YOUR_APP_ID --force-login

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

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

  1. 直接Meta認証（独自のFacebookアプリ）を使用する場合は、 mcp_meta_ads_get_login_linkツールを呼び出して認証をテストします。
  2. Pipeboard 認証 (推奨) を使用する場合は、PIPEBOARD_API_TOKEN 環境変数が設定されていることを確認してください (トークンはhttps://pipeboard.coから取得できます)
  3. mcp_meta_ads_get_ad_accountsを呼び出してアカウントアクセスを確認します
  4. mcp_meta_ads_get_account_infoで特定のアカウントの詳細を確認します

これらの関数は、必要に応じて自動的に認証を処理し、必要に応じてクリック可能なログイン リンクを提供します。

トラブルシューティング

認証の問題

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

  1. LLM インターフェイスを使用する場合:
    • 直接Meta認証（独自のFacebookアプリ）を使用する場合は、 mcp_meta_ads_get_login_linkツールを使用して新しい認証リンクを生成します。
    • Pipeboard 認証 (推奨) を使用する場合は、PIPEBOARD_API_TOKEN 環境変数が設定されていることを確認してください (トークンはhttps://pipeboard.coから取得できます)
    • リンクをクリックしてブラウザで認証フローを完了してください
    • コールバックサーバーが適切に実行されていることを確認します（ツールがこれを報告します）
  2. Pipeboard 認証を使用する場合:
    • PIPEBOARD_API_TOKENが正しく設定されていることを確認してください（トークンはhttps://pipeboard.coから取得できます）
    • 提供されたログイン URL にアクセスして、認証プロセスを完了する必要があるかどうかを確認します。
    • 新しいログインを強制してみます: python test_pipeboard_auth.py --force-login
  3. 直接Meta OAuthを使用する場合:
    • 新しいトークンを取得するには、 --force-loginを付けて実行します: uvx meta-ads-mcp --login --app-id YOUR_APP_ID --force-login
    • 端末にブラウザウィンドウを開く権限があることを確認してください

APIエラー

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

  1. アプリにマーケティング API 製品が追加されていることを確認します
  2. ユーザーが広告アカウントに対して適切な権限を持っていることを確認する
  3. アプリにレート制限やその他の制限がないか確認する

バージョン管理

パッケージの現在のバージョンを確認できます:

import meta_ads_mcp print(meta_ads_mcp.__version__)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

AI モデルが Meta 広告キャンペーンにアクセスし、分析および管理できるようにするモデル コンテキスト プロトコル サーバー。これにより、LLM はパフォーマンス データを取得し、広告クリエイティブを視覚化し、Facebook および Instagram プラットフォームに戦略的な洞察を提供できるようになります。

  1. Features
    1. Installation
      1. Using uv (recommended)
      2. Using pip
    2. Configuration
      1. Quick Start with Pipeboard Authentication (Recommended)
      2. Usage with Cursor or Claude Desktop
      3. Available MCP Tools
    3. Create a Meta Developer App
      1. Authentication
        1. 1. Pipeboard Authentication (Recommended ⭐)
        2. 2. Direct Meta OAuth (Legacy)
      2. Troubleshooting and Logging
        1. Log Location
        2. Common Issues
        3. Debugging Command
      3. Running with Different App IDs
        1. Privacy and Security
          1. Testing
            1. CLI Testing
            2. LLM Interface Testing
          2. Troubleshooting
            1. Authentication Issues
            2. API Errors
          3. Versioning
            ID: 65ptv0a0ou