コンテンツへスキップ
Remote Sunrise

Remote Sunrise のガイド

SearchAds Manager を Codex に接続する

SearchAds ManagerでローカルMCPサーバーを有効にし、Codexに接続して、一時データを使ったApple Search Adsのスモークテストで動作を確認します。

戻る MCPの概要

独自のAPIスクリプトではなく、ローカルのSearchAds Managerアプリを通じてCodexからApple Search Adsを操作したい場合は、このページをご利用ください。

1. macOSアプリをセットアップ

  1. Codex

    ローカルMCPサーバーにリクエストを送信します。

  2. SearchAds Manager

    Macでサーバーを実行し、リクエストを処理します。

  3. Apple Ads

    アカウントデータを返すか、承認済みのキャンペーン操作を実行します。

MacでSearchAds Managerを起動したままにしてください。アプリで設定したAPIアクセスを使ってApple Adsに接続します。
  1. macOSでSearchAds Managerを起動します。
  2. 設定を開きます。
  3. 通常のApple Search Ads認証情報がまだ設定されていない場合は、設定してください。
  4. オートメーションを開き、Codex MCPサーバーのセクションを探してください。
  5. サーバーを有効にします。
  6. 必要に応じてポートとトークンを確認、変更します。
  7. サーバー設定を適用をクリックします。
「オートメーション」が選択され、「ローカルMCPサーバーを有効にする」にチェックが入っているSearchAds Managerの設定画面
Macで「設定」→「オートメーション」を開き、ローカルMCPサーバーを有効にしてください。サーバー設定を適用してから、アプリに表示されるCodexのコマンドをコピーしてください。

認証情報がまだ設定されていない場合は、AppleのOAuthガイド「Apple Search Ads API向けのOAuthの実装」に従ってください。

2. サーバーをCodexに追加

設定カードに、実行する正確なコマンドが表示されます。コマンドの形式は次のとおりです:

codex mcp add searchads --url "http://127.0.0.1:7717/mcp?token=YOUR_TOKEN"

追加後:

  1. macOSアプリを起動したままにしてください。
  2. 作業するリポジトリで新しいCodexセッションを開始するか、クライアントが対応している場合はMCPサーバーに再接続してください。
  3. APIスクリプトを手作業で作成する代わりに、レポートの取得や書き込み操作にはsearchadsサーバーを使用してください。
  1. adam_idが必要な場合は、最初にlist_appsを呼び出してください。
  2. 有効な国コードが必要な場合は、キャンペーンを作成する前にlist_supported_countriesを呼び出してください。
  3. 変更を加える前に、get_campaign_report、get_adgroup_report、get_keyword_reportで成果を確認してください。
  4. 変更を加える前に、list_campaigns、list_adgroups、list_keywordsで現在の状態を確認してください。
  5. 作成処理には、create_campaigns、add_adgroups、add_keywordsを使用してください。
  6. 変更内容を管理しながら編集するには、update_campaigns、update_adgroups、update_keywordsを使用してください。
  7. delete_campaigns、delete_adgroups、delete_keywordsは、削除を伴うクリーンアップを明示的に行う場合にのみ使用してください。
  8. 失敗した内容を確認しやすくするため、書き込みは対象を明確にした小さなバッチに分けて行ってください。

4. トラブルシューティング

  1. Codexが接続できない場合は、macOSアプリが開いていることと、サーバーのステータスが実行中になっていることを確認してください。
  2. 設定エラーでツールの呼び出しに失敗する場合は、アプリの設定でApple Search Adsの認証情報を再確認してください。
  3. トークンを再生成したりポートを変更したりした場合は、新しいURLでcodex mcp add ...を再実行してください。

5. 一時データを使ったスモークテスト用プロンプト

任意で使えるスモークテスト用プロンプトを表示

作成したテスト用IDをCodexが記憶できるよう、以下のプロンプトは同じCodexセッションで実行してください。

mcp-smoke-...など、一時データ用の接頭辞を名前に付け、最後にすべて削除してください。新しく作成したテスト用エンティティは、通常、レポートの指標がゼロになります。それでもMCP経由のレポート取得経路を検証できます。

情報取得用プロンプト

`searchads` MCPサーバーのみを使って、MCPのスモークテスト環境を準備してください。

1. 一時的なテストキャンペーンに安全に使える、私が所有するアプリを探してください。「Monitor and Manage Search Ads」に一致するアプリを優先し、見つからない場合は所有アプリを先頭から5個表示して、その中から一つ選んでください。
2. `list_supported_countries`を呼び出し、`US`がサポートされていれば選択してください。そうでなければ、サポートされている国を一つ選び、選択した国コードを教えてください。
3. 名前が`mcp-smoke-`で始まるキャンペーンについて、`list_campaigns`を呼び出してください。
4. 選択した`adam_id`、国コード、`mcp-smoke-YYYYMMDD-HHMMSS`形式の一意なテスト用プレフィックスを教えてください。
5. まだ何も作成しないでください。

キャンペーン作成用プロンプト

`searchads` MCPサーバーのみを使って、先ほど選択したアプリと国を対象に、`<PREFIX>-campaign`という名前の一時停止中のテスト用キャンペーンを一つ作成してください。このキャンペーンはテスト後に削除するものです。

以下を使用してください。
- 選択した`adam_id`
- 国コードを一つ
- `daily_budget_amount`は5
- `currency`は`USD`

作成後、テスト用プレフィックスを指定して`list_campaigns`を呼び出し、新しい`campaign_id`を返してください。

キャンペーンのレポート取得と更新用プロンプト

`searchads` MCPサーバーのみを使って、以下を実行してください。

1. `<CAMPAIGN_ID>`に対して、`days: 0`を指定して`get_campaign_report`を呼び出してください。
2. `update_campaigns`でそのキャンペーンを更新し、日予算を6 USD、ステータスを`ENABLED`にしてください。
3. テスト用プレフィックスを指定して、もう一度`list_campaigns`を呼び出してください。
4. 更新前後のキャンペーンの状態をまとめてください。

広告グループ追加用プロンプト

`searchads` MCPサーバーのみを使って、`<CAMPAIGN_ID>`に一時停止中の広告グループを二つ追加してください。

1. `<PREFIX>-ag-1`
2. `<PREFIX>-ag-2`

以下を使用してください。
- `default_bid_amount`は1
- `currency`は`USD`
- `automated_keywords_opt_in`はfalse

作成後、そのキャンペーンに対して`list_adgroups`を呼び出し、両方の`ad_group_id`の値を返してください。

広告グループのレポート取得と更新用プロンプト

`searchads` MCPサーバーのみを使って、以下を実行してください。

1. `<CAMPAIGN_ID>`に対して、`days: 0`を指定して`get_adgroup_report`を呼び出してください。
2. `update_adgroups`で`<PREFIX>-ag-1`を更新し、ステータスを`ENABLED`、`default_bid_amount`を1.2 USD、`cpa_goal_amount`を4 USDにしてください。
3. `<CAMPAIGN_ID>`に対して、もう一度`list_adgroups`を呼び出してください。
4. 更新した広告グループの状態をまとめ、その`ad_group_id`を返してください。

キーワード追加用プロンプト

`searchads` MCPサーバーのみを使って、一つの`keyword_set`で`<CAMPAIGN_ID>`内の`<AD_GROUP_ID>`にキーワードを追加してください。

以下を使用してください。
- `default_bid_amount`は0.8
- `default_currency`は`USD`

次のキーワードを追加してください。
1. `<PREFIX> exact`：`match_type`は`EXACT`、`status`は`ACTIVE`
2. `<PREFIX> broad`：`match_type`は`BROAD`、`status`は`ACTIVE`

作成後、`<CAMPAIGN_ID>`と`<AD_GROUP_ID>`を指定して`list_keywords`を呼び出し、作成した`keyword_id`の値を返してください。

キーワードのレポート取得と更新用プロンプト

`searchads` MCPサーバーのみを使って、以下を実行してください。

1. `<CAMPAIGN_ID>`と`ad_group_ids: [<AD_GROUP_ID>]`に対して、`days: 0`を指定して`get_keyword_report`を呼び出してください。
2. `update_keywords`でEXACTキーワードを更新し、入札額を0.9 USD、ステータスを`PAUSED`にしてください。
3. `<CAMPAIGN_ID>`と`<AD_GROUP_ID>`を指定して、もう一度`list_keywords`を呼び出してください。
4. 更新したキーワードの状態をまとめ、両方のキーワードの現在の行データを返してください。

クリーンアップ用プロンプト

`searchads` MCPサーバーのみを使って、MCPスモークテストのデータを削除してください。

1. `delete_keywords`で`<AD_GROUP_ID>`内のすべてのテスト用キーワードを削除してください。
2. `<CAMPAIGN_ID>`と`<AD_GROUP_ID>`を指定して`list_keywords`を呼び出し、キーワードが削除されたことを確認してください。
3. `delete_adgroups`で両方のテスト用広告グループを削除してください。
4. `<CAMPAIGN_ID>`に対して`list_adgroups`を呼び出し、広告グループが削除されたことを確認してください。
5. `delete_campaigns`でテスト用キャンペーンを削除してください。
6. テスト用プレフィックスを指定して`list_campaigns`を呼び出し、キャンペーンが削除されたことを確認してください。
7. 削除結果をまとめてください。