SearchAds Managerには、アプリ内で動作するmacOS専用のローカルMCPサーバーが組み込まれており、アカウント設定で設定済みのApple Search Ads認証情報をそのまま使用します。

できること

• キャンペーンを作成する前に、所有するアプリと対応する国を確認できます。
• 独自のAPIスクリプトを作成せずに、キャンペーン、広告グループ、キーワードのレポートを取得できます。
• 認証付きのローカルエンドポイントを通じて、Codexからキャンペーン、広告グループ、キーワードを作成、更新、削除できます。
• アプリの実行中は、接続をMac内に限定します。

実行の仕組み

1. サーバーは127.0.0.1にのみバインドします。
2. サーバーは、macOSアプリが実行されている間だけ利用できます。
3. アクセスは、生成されてアプリ設定に保存されるトークンで保護されます。
4. MCPエンドポイントは/mcpです。
5. /healthでヘルスチェック用エンドポイントを利用できます。

SearchAds Managerの設定

macOS版の設定画面には、次の項目を含むCodex MCPサーバーカードがあります:

1. 有効化の切り替えスイッチ
2. 設定可能なTCPポート
3. 生成されたアクセストークン
4. 認証情報を含む完全なMCP URL
5. そのまま実行できるCodexコマンド
6. ローカルリスナーの状態表示

利用可能なMCPツール

情報取得とメタデータ

• list_apps
• list_supported_countries

レポート

• get_campaign_report
• get_adgroup_report
• get_keyword_report

キャンペーン管理

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

広告グループ管理

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

キーワード管理

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

一般的な作業手順

1. list_appsを呼び出して、宣伝したいアプリのadam_idを調べます。
2. list_supported_countriesを呼び出して、有効な国または地域のコードを確認してください。
3. get_campaign_report、get_adgroup_report、またはget_keyword_reportで現在の成果を確認します。
4. list_campaigns、list_adgroups、list_keywordsで現在の状態を確認します。
5. エラーを把握しやすく、必要に応じて変更を元に戻しやすくするため、書き込みは対象を明確にした小さなバッチに分けて適用してください。

次のステップ

サーバーをCodexに追加し、一時データを使ったスモークテストを実行するには、SearchAds ManagerをCodexに接続を開いてください。