mcpField
M
meta-ads

meta-ads

ローカル
github.com/mikusnuzビジネス・マーケティング911 週間前に更新
リポジトリ

meta-ads について

meta-adsは、Meta Marketing APIを通じてFacebookとInstagramの広告を管理するMCPサーバーです。キャンペーン運用、オーディエンス管理、レポート、自動化のツールをマーケティングチームに提供します。

主な機能

  1. 01キャンペーンと広告セットの管理
  2. 02クリエイティブとメディア素材の管理
  3. 03オーディエンスターゲティングと類似オーディエンス作成
  4. 04パフォーマンス分析と非同期レポート
  5. 05カタログと商品フィードの管理
  6. 06ルール、実験、コンバージョンの管理

活用シーン

  1. 01FacebookとInstagramの広告キャンペーン作成・更新
  2. 02アカウントやキャンペーンの広告実績確認
  3. 03カスタムまたは類似オーディエンスの作成
  4. 04成果の低い広告への自動アクション設定

MCP 対応

キャンペーン、オーディエンス、レポート、カタログ管理など、Meta Marketing APIの操作をツールとしてMCPクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "mikusnuz-meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "<META_ADS_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>",
        "META_APP_ID": "<META_APP_ID>",
        "META_APP_SECRET": "<META_APP_SECRET>",
        "META_BUSINESS_ID": "<META_BUSINESS_ID>",
        "META_PIXEL_ID": "<META_PIXEL_ID>"
      }
    }
  }
}
起動コマンドnpx -y @mikusnuz/meta-ads-mcp
設定が必要な環境変数
META_ADS_ACCESS_TOKENシークレットMeta Marketing API access token
META_AD_ACCOUNT_IDMeta Ad Account ID (e.g. act_123456)
META_APP_IDMeta App ID
META_APP_SECRETシークレットMeta App Secret
META_BUSINESS_IDMeta Business Manager ID
META_PIXEL_IDMeta Pixel ID

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@mikusnuz/meta-ads-mcp1.6.1

ツール

134

掲載時のツール一覧 · 1 週間前に更新

パラメーター型必須説明
afterstringいいえ次のページのページネーションカーソル
limitnumberいいえ結果数（デフォルトは 25）
beforestringいいえ前のページのページネーションカーソル
fieldsstringいいえ返すフィールドをカンマ区切りで指定します。
statusstringいいえステータスでフィルタリング：ACTIVE、PAUSED、DELETED、ARCHIVED
objectivestringいいえ目的でフィルタリング：OUTCOME_AWARENESS、OUTCOME_ENGAGEMENT、OUTCOME_LEADS、OUTCOME_SALES、OUTCOME_TRAFFIC、OUTCOME_APP_PROMOTION
account_idstringいいえクエリ対象の広告アカウント ID（例：'act_123' または '123'）。省略した場合は META_AD_ACCOUNT_ID 環境変数にフォールバックします。

詳細

meta-ads-mcp

npm version License: MIT

Meta Marketing API v26.0 用の MCP サーバーです。Facebook と Instagram の広告キャンペーン、オーディエンス、クリエイティブ、インサイト、カタログなどを管理する 134 個のツールを提供します。

使用する場面

次のような場合にこの MCP を使用します。

  • 「Facebook 広告キャンペーンを新規作成する」 — create_campaign、create_adset、create_ad、create_creative を使って、フルファネルを構築します
  • 「今日の広告のパフォーマンスを確認する」 — 今日の日付範囲を指定して、get_account_insights または get_campaign_insights を使用します
  • 「ROAS が 2 未満のキャンペーンをすべて一時停止する」 — list_campaigns と get_campaign_insights を使ってパフォーマンスの低いキャンペーンを見つけてから、update_campaign で一時停止します
  • 「2 つの広告クリエイティブ間で A/B テストを設定する」 — create_experiment を使って、広告セット間の比較テストを実施します
  • 「顧客から類似オーディエンスを作成する」 — create_custom_audience、add_users_to_audience の順に使用し、その後 create_lookalike_audience を使います
  • 「広告画像をアップロードしてカルーセル広告を作成する」 — 各画像に upload_image を使用し、その後カルーセル形式で create_creative を使います
  • 「過去 30 日間の詳細なパフォーマンスレポートを取得する」 — 広い日付範囲には create_async_report を使用し、その後 get_async_report で取得します
  • 「Facebook 広告ライブラリで競合他社の広告を検索する」 — search_ad_library を使って公開広告データを検索します
  • 「パフォーマンスの低い広告を一時停止する自動ルールを設定する」 — CPA がしきい値を超えるなどの条件を指定して create_rule を使用します
  • 「ダイナミック広告用の商品カタログを管理する」 — create_catalog、create_feed、upload_feed を使ってダイナミック商品広告を設定します

v1.6.0 の新機能

  • create_adset で bid_amount を指定できるようになりました。作成と更新では dsa_beneficiary および dsa_payor も指定できます。EU をターゲットとする広告では、必須の値をそれぞれ指定するか、対応するアカウントのデフォルトを設定してください。支払者の値は受益者から自動的にコピーされません。
  • 広告と広告セットのリスト取得では、スコープが指定されている場合にキャンペーン／広告セットのエッジを使用します。キャンペーンと広告セットを組み合わせたフィルター、および明示的なアカウント ID の整合性を確認します。
  • create_adset と update_adset で destination_type、attribution_spec、adset_schedule、pacing_type、validate_only を指定できるようになりました。既存の呼び出しでは、引き続き要求された書き込みが実行されます。変更を加えずに Meta の検証を依頼するには、validate_only: true を設定してください。検証に成功しても広告セットは作成されません。
  • 時間単位のスケジュールでは、分の範囲と曜日を指定できます（日曜日 = 0）。timezone_type には USER または ADVERTISER を指定してください。スケジュールを設定すると、day_parting ペーシングが追加されます。Meta は有効なライフタイム予算、目的の適格性、アトリビューションの制限を検証します。予算やステータスが自動的に変更されることはありません。
  • create_custom_audience で、ルールベースのオーディエンス用に JSON の rule、pixel_id、retention_days を指定できるようになりました。オーディエンスの作成は実際の書き込みであり、ドライランではありません。

公式の広告セット作成および広告セット更新の仕様を参照してください。

v1.5.0 の新機能

  • コンバージョンツールでは、既存の events JSON 入力を検証し、必須の data 配列として送信します。Events Manager で受信を確認するには test_event_code を使用してください。オフラインイベントではデータセット ID を使用し、店舗イベントでは action_source=physical_store を指定します。
  • クリエイティブの作成では、トップレベルの destination_spec、wamo_whatsapp_identity_spec、degrees_of_freedom_spec JSON オブジェクトを指定できます。ダイナミッククリエイティブでは、ページのアイデンティティを指定する object_story_spec も使用できます。v26 の Shops のデフォルト宛先をオプトアウトするには、destination_spec に {"destination_type":"WEBSITE_AND_SHOP_OPT_OUT"} を設定してください。
  • v1.4.1 以降の、非同期レポート結果の完全な取得、トークンの延長、予算スケジュールの修正が含まれます。一部の詳細なインサイトの内訳を利用するには、Ads Manager でのオプトインが必要です。空の応答が必ずしもパフォーマンスがゼロであることを意味するわけではありません。

インストール

MCP ホストの npx 環境を含め、Node.js 20 以降が必要です。

{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/meta-ads-mcp"],
      "env": {
        "META_ADS_ACCESS_TOKEN": "your-access-token",
        "META_AD_ACCOUNT_ID": "123456789",
        "META_APP_ID": "your-app-id",
        "META_APP_SECRET": "your-app-secret",
        "META_BUSINESS_ID": "your-business-id",
        "META_PIXEL_ID": "your-pixel-id"
      }
    }
  }
}

環境変数

変数必須説明
META_ADS_ACCESS_TOKENはいMeta Marketing API のアクセストークン
META_AD_ACCOUNT_IDはい広告アカウント ID（act_ 接頭辞を含まない数値）
META_APP_ID任意アプリ ID — トークン交換／延長およびデバッグに必要
META_APP_SECRET任意アプリシークレット — トークン交換／延長およびデバッグに必要
META_BUSINESS_ID任意Business Manager ID — ビジネスツールに必要
META_PIXEL_ID任意ピクセル ID — コンバージョンツールに必要

ツール（134）

キャンペーン管理（25）
ツール説明
list_campaignsフィルタリングとページネーションを使用してキャンペーンを一覧表示
get_campaignID でキャンペーンの詳細を取得
create_campaign新しいキャンペーンを作成
update_campaignキャンペーンの設定を更新
delete_campaignキャンペーンを削除
copy_campaign広告セットと広告を含めて既存のキャンペーンをコピー
get_campaign_adsetsキャンペーン内の広告セットを一覧表示
get_campaign_adsキャンペーン内の広告を一覧表示
get_campaign_leadsキャンペーンからリードを取得
list_adsetsフィルタリングして広告セットを一覧表示
get_adsetID で広告セットの詳細を取得
create_adset新しい広告セットを作成
update_adset広告セットの設定を更新
delete_adset広告セットを削除
copy_adset既存の広告セットを同じキャンペーンまたは別のキャンペーンにコピー
get_adset_targeting_sentenceターゲティングの内容を人が読める形式で取得
get_adset_ads広告セット内の広告を一覧表示
get_adset_leads広告セットからリードを取得
list_adsフィルタリングして広告を一覧表示
get_adID で広告の詳細を取得
create_ad新しい広告を作成
update_ad広告の設定を更新
delete_ad広告を削除
copy_ad既存の広告を同じ広告セットまたは別の広告セットにコピー
get_ad_preview広告のプレビュー HTML を生成
get_delivery_estimate広告セットの配信予測を取得
クリエイティブ（6）
ツール説明
list_creatives広告クリエイティブを一覧表示
get_creativeクリエイティブの詳細を取得
create_creative新しい広告クリエイティブを作成
update_creative広告クリエイティブを更新
create_dynamic_creativeダイナミッククリエイティブを作成
generate_preview既存の広告を使わずに、クリエイティブの仕様から広告プレビューを生成
メディアアセット（12）
ツール説明
list_images広告画像を一覧表示
upload_imageURL またはローカルファイルから画像をアップロード
get_image画像の詳細を取得
delete_image画像を削除
list_videos広告動画を一覧表示
upload_videoURL またはローカルファイルから動画をアップロード
get_video動画の詳細を取得
delete_video動画を削除
list_canvasesInstant Experience キャンバスを一覧表示
get_canvasキャンバスの詳細を取得
create_canvasキャンバスを作成
delete_canvasキャンバスを削除
オーディエンスとターゲティング（16）
ツール説明
list_custom_audiencesカスタムオーディエンスを一覧表示
get_audienceオーディエンスの詳細を取得
create_custom_audienceカスタムオーディエンスを作成
update_audienceオーディエンスの設定を更新
delete_audienceオーディエンスを削除
add_users_to_audienceカスタムオーディエンスにユーザーを追加
remove_users_from_audienceカスタムオーディエンスからユーザーを削除
create_lookalike_audience類似オーディエンスを作成
get_audience_healthオーディエンスの健全性、配信状況、マッチ率を取得
list_saved_audiences保存済みオーディエンスを一覧表示
get_saved_audience保存済みオーディエンスの詳細を取得
search_targetingターゲティングの興味・関心、行動、デモグラフィックを検索
search_locationsターゲティング可能な場所を検索
search_targeting_mapターゲティングカテゴリのツリーを参照
get_reach_estimateターゲティング仕様に基づいてオーディエンスのリーチを推定
get_targeting_suggestions関連するターゲティング候補を取得
インサイトとレポート（6）
ツール説明
get_account_insightsアカウントレベルのパフォーマンス指標
get_campaign_insightsキャンペーンレベルのパフォーマンス指標
get_adset_insights広告セットレベルのパフォーマンス指標
get_ad_insights広告レベルのパフォーマンス指標
create_async_report非同期インサイトレポートを作成
get_async_reportレポート実行状況をポーリングし、完了後にその /insights の結果を取得

date_preset の値には、today、yesterday、last_7d、last_30d などの小文字の Graph API 識別子を指定します。create_async_report は常に非同期ジョブを作成します。get_async_report はステータスをすぐに返し、デフォルトではステータスが Job Completed になった後に、ページ分割された結果エッジを取得します。

リード（5）
ツール説明
get_form_leadsリードフォームからリードを取得
get_leadID を指定して単一のリードを取得
create_lead_formページに新しいリード獲得フォームを作成
list_lead_formsページのリード獲得フォームを一覧表示
get_lead_formリードフォームの詳細を取得
カタログとコマース（17）
ツール説明
list_catalogs商品カタログを一覧表示
get_catalogカタログの詳細を取得
create_catalog商品カタログを作成
update_catalogカタログを更新
list_product_setsカタログ内の商品セットを一覧表示
create_product_set商品セットを作成
get_product_set商品セットの詳細を取得
update_product_set商品セットを更新
list_productsカタログ内の商品を一覧表示
get_product商品の詳細を取得
update_product商品を更新
list_feedsカタログのデータフィードを一覧表示
create_feedデータフィードを作成
upload_feedデータをフィードにアップロード
get_feed_uploadsフィードのアップロード履歴を取得
batch_products商品を一括作成、更新、または削除（1 リクエストあたり最大 5,000 件）
get_batch_statusカタログの一括操作のステータスを確認
自動化とルール（5）
ツール説明
list_rules自動化ルールを一覧表示
get_ruleルールの詳細を取得
create_rule自動化ルールを作成
update_ruleルールを更新
delete_ruleルールを削除
実験（5）
ツール説明
list_experimentsA/B テストの実験を一覧表示
create_experiment実験を作成
get_experiment実験の詳細を取得
update_experiment実験を更新
get_experiment_results実験結果を取得
コンバージョン（4）
ツール説明
send_conversion_eventConversions API を介してサーバー側のコンバージョンイベントを送信
send_offline_eventオフラインコンバージョンイベントを送信
list_offline_event_setsオフラインイベントセットを一覧表示
create_offline_event_setオフラインイベントセットを作成
予算と計画（8）
ツール説明
list_budget_schedulesキャンペーンまたは広告セットの budget_schedules エッジからスケジュールを一覧表示します
create_budget_scheduleキャンペーンまたは広告セットにスケジュールを作成します
update_budget_schedule予算スケジュールを更新します
delete_budget_schedule予算スケジュールを削除します
list_rf_predictionsリーチ＆フリークエンシーの予測を一覧表示します
create_rf_predictionリーチ＆フリークエンシーの予測を作成します
get_rf_prediction予測の詳細を取得します
delete_rf_prediction予測を削除します
ブランドセーフティ（5）
ツール説明
list_block_listsパブリッシャーのブロックリストを一覧表示します
create_block_listブロックリストを作成します
add_to_block_listURL／ドメインをブロックリストに追加します
remove_from_block_listブロックリストから項目を削除します
delete_block_listブロックリストを削除します
アカウントとビジネス（15）
ツール説明
get_ad_account広告アカウントの詳細を取得します
list_ad_accountsビジネスの広告アカウントを一覧表示します
update_ad_account広告アカウントの設定を更新します
get_account_activitiesアカウントのアクティビティログを取得します
list_account_usersアカウントへのアクセス権を持つユーザーを一覧表示します
list_businessesアクセス権を持つビジネスを一覧表示します
get_businessビジネスの詳細を取得します
list_business_ad_accountsビジネス内の広告アカウントを一覧表示します
list_business_usersビジネス内のユーザーを一覧表示します
add_business_userビジネスにユーザーを追加します
remove_business_userビジネスからユーザーを削除します
list_business_pagesビジネスが所有するFacebookページを一覧表示します
list_business_instagram_accountsビジネスが所有するInstagramアカウントを一覧表示します
list_system_usersビジネスのシステムユーザーを一覧表示します
create_system_userシステムユーザーを作成します
認証とトークン（3）
ツール説明
exchange_token短期間有効なトークンを長期間有効なトークンと交換します
refresh_tokenドキュメントに記載された交換フローを通じて、有効な長期間有効なユーザートークンの有効期間を延長します
debug_tokenトークンのメタデータをデバッグ／確認します
広告ライブラリ（1）
ツール説明
search_ad_library公開広告データをMeta広告ライブラリで検索します

リソース（3）

URI説明
ads://account広告アカウントの概要 — ステータス、残高、通貨、タイムゾーン、合計広告費
ads://campaigns-overview予算情報を含むすべての実施中キャンペーン
ads://spending-today本日の広告費の概要 — 広告費、インプレッション数、クリック数、リーチ

プロンプト（3）

プロンプト説明
campaign_wizard広告キャンペーンをゼロから作成するためのステップごとのガイド
performance_report詳細な内訳と推奨事項を含めて広告のパフォーマンスを分析します
audience_builderMetaのターゲティングツールを使ってターゲットオーディエンスを作成、調整します

必要な権限

使用するツールに応じて、Metaアクセストークンには以下の権限が必要です。

権限ツール
ads_managementすべてのキャンペーン、広告セット、広告、クリエイティブのCRUD操作
ads_readすべての読み取り／一覧表示操作とインサイト
business_managementビジネスツール、システムユーザー、アカウントの割り当て
leads_retrievalリードフォームとリードデータのツール
catalog_managementカタログ、商品セット、商品、フィードのツール
pages_read_engagementページにリンクされたリードフォーム

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。