ZuckerBot — Meta Ads MCP Server

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

ZuckerBotを選ぶ理由

エージェントはすでにコードを書き、ファイルを管理し、ウェブを検索できます。広告も管理できるべきです。

ZuckerBotは、MCPを通じてあらゆるAIエージェントにMeta Adsの全機能を提供します。ダッシュボードも、使い方を覚えるUIも、ログインするプラットフォームも必要ありません。エージェントにインストールして広告アカウントを接続すれば、すぐに作業を始められます。

ZuckerBotでエージェントができること：

• 1つのメッセージで広告アカウントを監査 — レビューが必要な広告費、クリエイティブの疲弊度、機会スコア、優先順位付きのアクション項目を提示（無料プランに含まれます）
• キャンペーンのパフォーマンスを取得し、効果が出ているものを特定
• 広告クリエイティブを分析し、次にテストする内容を提案
• ターゲティングと予算を設定してキャンペーンを作成・開始
• カスタムオーディエンスや類似オーディエンスを作成
• サーバーサイドのコンバージョントラッキング（CAPI）を設定
• 競合他社、レビュー、市場ベンチマークを調査
• 広告クリエイティブのブリーフやコピーを作成

仕組み

You ↔ Your Agent (Claude, ChatGPT, OpenClaw, Cursor, etc.)
                  ↕
            ZuckerBot MCP
                  ↕
         Meta Marketing API

Meta APIの複雑な処理はZuckerBotが担い、会話はエージェントが担当します。意思決定はあなたが行います。

インストール

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

OpenClaw

MCP設定に追加します：

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

Cursor / Windsurf / あらゆるMCPクライアント

同じ設定パターンで利用できます。ZuckerBotは、Model Context Protocolに対応するあらゆるクライアントで動作します。

リモートMCP（インストール不要）

ローカルで実行したくない場合は、ホスト型Streamable HTTPエンドポイント https://zuckerbot.ai/api/mcp を利用できます。同じツールを提供します。

• claude.ai — カスタムコネクターとして追加（Settings → Connectors → Add custom connector）し、OAuthで認証するか、Authorization: Bearer zb_live_... ヘッダーを渡します。
• Claude Code:

claude mcp add --transport http zuckerbot https://zuckerbot.ai/api/mcp --header "Authorization: Bearer zb_live_..."

• あらゆるStreamable HTTPクライアント — APIキーをベアラートークンとして指定し、https://zuckerbot.ai/api/mcp に接続します。

CLI（人間向け）

npm install -g zuckerbot-mcp

zuckerbot preview https://your-business.com
zuckerbot meta status
zuckerbot create https://your-business.com --budget 5000 --objective leads

ツール（50以上）

監査とライセンス（2）

セットアップとアカウント（7）

キャンペーン（9）

オーディエンス（6）

クリエイティブ（8）

* クリエイティブ画像／動画の生成ツール（generate_static_ad、generate_video_ad、get_video_ad_status、generate_creatives、request_creative）はデフォルトで無効です。MCP設定の環境変数にZUCKERBOT_ENABLE_CREATIVE_TOOLS=1を設定すると有効になります（有料アドオンを近日提供予定）。クリエイティブの分析ツールはすべて引き続き利用できます。

コンバージョントラッキング／CAPI（5）

レポート（2）

get_campaign_insights では、Ads Manager と照合済みの、単一の数値にまとめられていない3種類のリード数を確認できます。

費用は spend / count で算出されます。Meta の cost_per_action_type は加算できないため、合計されることはありません。同じフィールドは summary にも集計され、total_meta_result / blended_cost_per_meta_result（meta_result_type を含む）、total_meta_leads / blended_cost_per_meta_lead、total_conversion_leads / blended_cost_per_conversion_lead として表示されます（total_leads / blended_cpl は、各行に対応する項目と同様に非推奨です）。

ポートフォリオ（5）

リサーチ（3）

ビジネスコンテキスト（4）

典型的なエージェントのフロー

0. Audit       →  audit_account (how is this account doing today?)
1. Research    →  research_reviews + research_competitors (parallel)
2. Preview     →  preview_campaign (show user what ads look like)
3. Create      →  create_campaign with mode=legacy (launch-ready draft)
4. Review      →  confirm targeting, creative, Meta connection, and budget
5. Launch      →  launch_campaign after explicit approval
6. Monitor     →  get_performance + creative_analysis
7. Pause       →  pause_campaign whenever delivery must stop
8. Optimise    →  sync_conversion + audience tools

すべてのツールは、次に行うべき論理的なステップを提案する _hint フィールドを返すため、エージェントは常に次に何をすべきか把握できます。 略式フロー：旧式の作成 → レビュー → 起動 → 監視。インテリジェンスの有効化とポートフォリオの起動は現在一時的に利用できません。既存の Meta オブジェクトでは、仕様から構築したキャンペーンや外部キャンペーンに、以下のレビュー済み再開ワークフローを使用します。 MCP の名称には、zuckerbot_enrich_business、zuckerbot_upload_business_context、zuckerbot_get_campaign、zuckerbot_activate_campaign、zuckerbot_create_seed_audience などがあります。 zuckerbot_duplicate_ad は、同じ広告アカウント内の既存の広告セットに、対応する広告を 1 つ複製します。デフォルトではドライランで実行され、作成される広告は常に一時停止状態です。また、idempotency_key が明示的に指定された場合にのみ実行されるため、再試行によって広告が二重に作成されることはありません。 zuckerbot_upload_ad_asset は、ホストされた https URL から接続済み広告アカウントのライブラリに、新しい画像または動画ファイルをアップロードします（Meta がファイルを直接ダウンロードします）。image_hash または video_id を返します。動画の場合は、処理が完了するまで zuckerbot_get_ad_asset_status をポーリングしてください。 zuckerbot_create_ad はその後、そのアセットから新しいクリエイティブ 1 つと、新しい一時停止状態の広告 1 つを、既存の任意の広告セットに作成します。ZuckerBot 外で構築された配信中のキャンペーンも対象です。複製と同じく、まずドライランを行い、idempotency_key の指定がある場合にのみ実行されます。

ZuckerBot と代替サービスの比較

料金

無料プランですぐに利用を始められます。Pro は、キャンペーンを 1 つ最適化するだけで料金の元が取れます。

API キーを取得

ライフタイムディール

Dealify で ZuckerBot のライフタイムライセンスを購入しましたか？コードは ZB-XXXXX-XXXXX-XXXXX の形式で、1 つのアカウントに複数適用できます。

zuckerbot_redeem_license ツール（「ZuckerBot のコード ZB-... を引き換えて」）を使ってエージェントから直接引き換えるか、ブラウザーで zuckerbot.ai/start.html にアクセスして引き換えてください。引き換えると、アカウント上のすべての API キーがアップグレードされます。まだキーを持っていない場合は、新しいキーが発行されます（表示は一度だけなので、保存してください）。

会話例

あなた： 今週の Meta キャンペーンの状況はどうですか？

エージェント は get_account_insights + creative_analysis を呼び出します

エージェント： 今週は 4 つのキャンペーンで $2,340 を消費しました。LAL キャンペーンは CPL が $28 と非常に好調で、アカウント平均を 40% 下回っています。一方、ブロードターゲティングのキャンペーンは CPL が $95 で、予算を消費し続けています。「お客様の声」クリエイティブの CTR は 3.2% で、商品写真の 1.1% を上回っています。ブロードターゲティングのキャンペーンを一時停止し、その予算を LAL に移すことをおすすめします。

あなた： 実行してください。

エージェント は pause_campaign + （予算調整）を呼び出します

開発

git clone https://github.com/DatalisHQ/zuckerbot.git
cd zuckerbot
npm install
npm run build
npm start

ライセンス

MIT

一時停止中の仕様ビルド済みキャンペーンを有効化する

zuckerbot_resume_campaign（POST /v1/meta/resume）を使用し、実際の Meta campaign_id（仕様ビルド済みまたは外部キャンペーン。ZuckerBot が管理する下書きは対象外）、任意の business_id、および entity_level（ad、adset、または campaign）を指定します。広告または広告セットの場合は、その entity_id を含めてください。

1. dry_run: true（既定値）で呼び出します。返された階層、アカウントの 通貨、予算、キャンペーンの支出上限、広告セットの終了日を確認し、ユーザーと共有します。 金額は通貨の最小単位です。日予算は支出総額の上限ではありません。
2. 明示的な承認を得た後、同じ対象を dry_run: false、 confirm_spend: true、返された preview_hash、および一意の idempotency_key（英字、数字、ピリオド、アンダースコア、コロン、ハイフンを8～128文字）とともに送信します。
3. 新たに仕様からビルドする場合は、対象の広告ごとに、次に広告セットごとに、最後に キャンペーンについて同じ手順を繰り返します。操作ごとに新しいプレビューを取得してください。有効化が他の一時停止中のオブジェクトに連鎖することはなく、すべての支出制御が維持されます。
4. これらのオブジェクトを停止するには zuckerbot_pause_campaign を使用します。キャンペーンレベルの一時停止では、実際の Meta キャンペーン ID を指定します。必要に応じて business_id を渡してください。

転送エラーが発生した場合は、同じリクエストとキーで再試行してください。結果が不確かな場合は、追加の有効化を行う前に、稼働中のステータスを確認する（または一時停止する）必要があります。保存された成功レスポンスが示すのはその操作の内容です。リプレイしても、その後に一時停止されたオブジェクトが再有効化されることはありません。ACTIVE は設定上のステータスです。Meta の審査、スケジュール、親／子のステータスによって、配信が妨げられる場合があります。広告セットが100件を超えるキャンペーン、または広告が100件を超えるキャンペーンでは、このプレビューのワークフローに Ads Manager が必要です。

ホスト型 MCP では、API のデプロイ時にこのツールが利用可能になります。インストール済みのローカル MCP クライアントでは、このツールを含むパッケージリリースが必要です。仕様ビルダーで作成したオブジェクトの有効化には、従来の下書き起動ツールは使用しません。

ローカル広告アセットのアップロード

ファイルがあるマシンで stdio MCP または CLI を実行します。 zuckerbot_upload_ad_asset は、asset_url、絶対パスの file_path、または files: [{ file_path, label? }]（最大20件）のいずれか1つだけを受け付けます。ローカルファイルは JPG/JPEG/PNG（最大30 MB）または MP4/MOV（最大4 GB）に対応しています。クライアントはバッチの開始前にすべてのファイルを検証し、サイズを制限したチャンクで非公開のまま転送して、ファイルごとの結果を順番どおりに返します。手動で公開ホスティングする必要はありません。 画像には image_hash、元の width、height、name が含まれます。動画では従来の処理ステータス／ポーリングのフローが維持されます。バッチ内の項目が失敗しても、すでにアップロードされたライブラリ内のファイルは取り消されません。ホスト型 MCP からローカルパスにはアクセスできません。ローカルクライアントまたは asset_url を使用してください。ライブラリへのアップロードによって広告が作成されたり、配信が有効になったりすることはありません。