amazon-ads

Amazon Ads

Amazon Ads スポンサープロダクトキャンペーンを管理するための戦略ガイドです。まずリサーチを行い、商品を検証してから、ACoS の目標に合わせて最適化します。

要件

• Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
• Amazon Ads の連携が接続されていること（https://app.hyperfx.ai/apps）。

search("amazon_ads_profiles_list") で amazon_ads_profiles_list が見つからない場合は、停止して、Hyper MCP を有効にし、Amazon Ads を接続するようユーザーに伝えてください。

このスキルのツールの実行方法

このスキルの各ツールには、正式なツール名が付いています。利用する環境の呼び出し方法で実行してください。

環境	ツールを探す	実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")、続けて describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"、続けて hyperai describe <name>	hyperai call <name> --json '{...}'

ツールが見つからない場合、その連携はワークスペースに接続されていないか、有効になっていません。停止して、接続が必要な連携をユーザーに伝えてください。

対象外 — 他のスキルに引き継ぐ項目

• クリエイティブの生成（商品画像、コピー）→ ad-creative-generation / image-generation。
• 複数プラットフォームでのキャンペーン開始 → Amazon にはこのスキルを使用し、その後、meta-ads / google-ads を個別に呼び出します。

ツール一覧

ツール	用途
amazon_ads_profiles_list、amazon_ads_health_check	プロファイルの検出と連携の状態確認。
amazon_ads_campaigns_list、amazon_ads_campaigns_create、amazon_ads_campaigns_update	キャンペーンのライフサイクル管理。
amazon_ads_ad_groups_create、amazon_ads_product_ads_create	広告グループと商品広告の作成。
amazon_ads_keywords_create、amazon_ads_negative_keywords_create、amazon_ads_campaign_negative_keywords_create	キーワードターゲティング。
amazon_ads_product_targets_create、amazon_ads_negative_product_targets_create	商品（ASIN／カテゴリー）ターゲティング。
amazon_ads_budget_rules_create、amazon_ads_budget_rules_list	予算の自動化。
amazon_ads_reports_create、amazon_ads_reports_status_get	パフォーマンスレポート。
amazon_ads_bid_recommendations_get	テーマ別の入札額の推奨。

重要なルール

重大：キーワード、除外キーワード、商品広告、商品ターゲットの操作には、ad_group_id と campaign_id の両方が必要です。campaign_id を省略すると、検証エラーが発生します。

重大：同じ広告グループ内で、キーワードターゲティングと商品ターゲティングを併用することはできません。広告グループごとに、どちらか一方のターゲティングタイプを選択してください。

重大：AUTO キャンペーンで使用できるのは、除外キーワードと除外商品ターゲットのみです。通常のキーワードと商品ターゲットは拒否されます。

重大：キャンペーンの日付には YYYY-MM-DD 形式を使用します。予算ルールの日付には YYYYMMDD 形式を使用します。取り違えないでください。

重大：キャンペーンは状態 "PAUSED" で作成してください。ユーザーの確認なしに、実際の配信を開始してはいけません。

重大：除外商品ターゲットがサポートするのは、ASIN_SAME_AS と ASIN_BRAND_SAME_AS の式のみです。カテゴリーの除外には対応していません。

重大：すべての列挙値は大文字で指定する必要があります：PAUSED、ENABLED、BROAD、PHRASE、EXACT、NEGATIVE_EXACT、NEGATIVE_PHRASE、MANUAL、AUTO。

重要：ベンダーアカウントでは、ポートフォリオ操作が 404 を返します。代わりに、キャンペーン単位で管理してください。

重要：予算ルールの作成が成功した後でも、一覧取得の結果が空になる場合があります。作成時のレスポンスからルール ID を記録してください。

重要：すべての予算額の単位はドルです（セントでもマイクロ単位でもありません）。1 日あたり 25 ドルの予算は 25 と指定します。

基本プロセス

検出 → リサーチ（商品＋キーワード）→ 戦略（自動または手動）→ 概要の承認 → 作成（PAUSED）→ キーワード／商品を追加 → 除外設定を追加 → テスト（1～3 日）→ 最適化 → ユーザーの承認がある場合にのみ有効化。

すべての参照ファイルは references/ にあります。 references/<file> から読み込んでください（例：references/discovery.md）。

ルーティング表

ユーザーの目的	最初に読むファイル
スポンサープロダクトキャンペーンを開始する	references/discovery.md → references/campaign-creation.md
既存のキャンペーンにキーワード／除外キーワード／商品ターゲットを追加する	references/campaign-creation.md
予算を自動化する（スケジュールまたはパフォーマンスルール）	references/budget-rules.md
パフォーマンス／ACoS／検索語句を分析する	references/reporting.md
入札額の推奨を取得する	references/reporting.md
マーケットプレイスをまたいで作業する（複数プロフィール）	references/reporting.md
目的がまだ明確でない	references/discovery.md — ディスカバリーで目的を明確にします

キャンペーンのステータス

• PAUSED：作成済みですが、配信されていません（安全なデフォルト設定）。
• ENABLED：実行中で、予算を消費しています。
• ARCHIVED：削除済みです（復元できません）。

既知の制限事項

問題	回避策
ポートフォリオ操作で404が返される（ベンダー側）	キャンペーン単位でグループ化し、命名規則を使用します。
予算ルールの一覧が空で返される場合がある	作成レスポンスからルールIDを記録します。
カテゴリーの推奨で失敗する場合がある（500）	手動で調査するか、ダッシュボードを使用します。

安全ルール

絶対に行わないこと：

• ASINやキーワードを推測すること。必ず確認してください。
• 調査／監査の段階を省略すること。
• 明示的な承認なしにキャンペーンを作成すること。
• ユーザーの同意なしにキャンペーンをENABLEDに設定すること。
• 入札額を推奨する際にACoSの目標値を無視すること。
• ユーザーが確認していない商品を追加すること。
• 同じ広告グループ内でキーワードと商品ターゲットを混在させること。
• キーワード／商品に関する操作でcampaign_idを省略すること。