amazon-ads

Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

Amazon Ads

Strategic guide for managing Amazon Ads Sponsored Products campaigns. Research first, validate products, optimize for ACoS targets.

Requirements

Hyper MCP installed and connected. https://app.hyperfx.ai/mcp
Amazon Ads integration connected at https://app.hyperfx.ai/apps.

If amazon_ads_list_profiles is not in the tool list, stop and tell the user to enable Hyper MCP and connect Amazon Ads.

Out of scope — defer to other skills

Creative generation (product imagery, copy) → `ad-creative-generation` / `image-generation`.
Cross-platform campaign launches → use this skill for Amazon, then invoke meta-ads / google-ads separately.

Tool surface

Tool	Purpose
`amazon_ads_list_profiles`, `amazon_ads_run_health_check`	Profile discovery + integration health.
`amazon_ads_list_campaigns`, `amazon_ads_create_campaign`, `amazon_ads_update_campaign`	Campaign lifecycle.
`amazon_ads_create_ad_group`, `amazon_ads_create_product_ad`	Ad group + product ad creation.
`amazon_ads_create_keyword`, `amazon_ads_create_negative_keyword`, `amazon_ads_create_campaign_negative_keyword`	Keyword targeting.
`amazon_ads_create_product_target`, `amazon_ads_create_negative_product_target`	Product (ASIN/category) targeting.
`amazon_ads_create_budget_rule`, `amazon_ads_list_budget_rules`	Budget automation.
`amazon_ads_create_report`, `amazon_ads_get_report_status`	Performance reporting.
`amazon_ads_get_bid_recommendations`	Theme-based bid recommendations.

Critical Rules

CRITICAL: Keyword, negative keyword, product ad, and product target operations require BOTH ad_group_id AND campaign_id. Omitting campaign_id causes validation errors.

CRITICAL: Keywords and product targets cannot coexist in the same ad group. Choose one targeting type per ad group.

CRITICAL: AUTO campaigns only allow negative keywords and negative product targets. Positive keywords and product targets are rejected.

CRITICAL: Campaign dates use YYYY-MM-DD format. Budget rule dates use YYYYMMDD format. Do not mix these up.

CRITICAL: Create campaigns with state "PAUSED". Never launch live without user review.

CRITICAL: Negative product targets only support ASIN_SAME_AS and ASIN_BRAND_SAME_AS expressions. Category exclusions are not supported.

CRITICAL: All enum values must be UPPERCASE: PAUSED, ENABLED, BROAD, PHRASE, EXACT, NEGATIVE_EXACT, NEGATIVE_PHRASE, MANUAL, AUTO.

IMPORTANT: Portfolio operations return 404 for vendor accounts. Use campaign-level management instead.

IMPORTANT: Budget rule listing may return empty even after successful creation. Track rule IDs from creation responses.

IMPORTANT: All budgets are in dollars (not cents, not micros). $25 daily budget = 25.

Core process

Discovery → Research (products + keywords) → Strategy (auto vs manual) → Approve Summary → Create (PAUSED) → Add Keywords/Products → Add Negatives → Test (1–3 days) → Optimize → Activate only with user approval.

All reference files live in `references/`. Read them at references/<file> (e.g. references/discovery.md).

Routing table

The user wants to…	Read these files first
Launch a Sponsored Products campaign	references/discovery.md → references/campaign-creation.md
Add keywords / negatives / product targets to an existing campaign	references/campaign-creation.md
Automate budgets (schedule or performance rules)	references/budget-rules.md
Analyze performance / ACoS / search terms	references/reporting.md
Get bid recommendations	references/reporting.md
Work across marketplaces (multi-profile)	references/reporting.md
Goal not yet clear	references/discovery.md — discovery clarifies the goal

Campaign Statuses

PAUSED: Created but not live (safe default).
ENABLED: Running and spending budget.
ARCHIVED: Deleted (cannot be restored).

Known Limitations

Issue	Workaround
Portfolio operations return 404 (vendor)	Use campaign-level grouping + naming conventions.
Budget rule listing may return empty	Track rule IDs from creation responses.
Category recommendations may fail (500)	Use manual research or dashboard.

Safety Rules

Never:

Assume ASINs or keywords — always ask.
Skip the research/audit phase.
Create campaigns without explicit approval.
Set campaigns to ENABLED without user consent.
Ignore ACoS targets when recommending bids.
Add products the user hasn't confirmed.
Mix keywords and product targets in the same ad group.
Omit campaign_id from keyword/product operations.