New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Plan and create Amazon Sponsored Products campaigns

Amazon ads

by hyperfx-ai · MIT license · ★ 90 on GitHub

Amazon ads cover

Plan and create Amazon Sponsored Products campaigns end-to-end via the Hyper MCP. Use when the user wants to launch Amazon Ads, set up Sponsored Products, manage keyword targeting and bids, configure ASIN or category product targeting,…

---
name: amazon-ads
description: Plan and create Amazon Sponsored Products campaigns end-to-end via the Hyper MCP. Use when the user wants to launch Amazon Ads, set up Sponsored Products, manage keyword targeting and bids, configure ASIN or category product targeting, add negative keywords, automate budget rules, analyze ACoS / ROAS, or generate Sponsored Products reports. Also triggers on amazon ppc, amazon campaign, amazon keywords, or amazon report.
requires_toolkits:
  - amazon_ads
icon: amazon_ads
short_description: Plan and create Amazon Sponsored Products campaigns with targeting and budget rules.
---

# 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](https://app.hyperfx.ai/mcp)
- **Amazon Ads integration connected** at [https://app.hyperfx.ai/apps](https://app.hyperfx.ai/apps).

Overview

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

Manual install (npx, ZIP)
Claude Codenpx skills add hyperfx-ai/marketing-skills --skill amazon-ads -g -a claude-code
Claude Code (degit)npx degit hyperfx-ai/marketing-skills/skills/amazon-ads#main ~/.claude/skills/amazon-ads
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.2 KB
Read SKILL.md here
hyperfx-ai/main1 file shown
SKILL.md
Show the full text115 lines

Amazon Ads

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

Requirements

If search("amazon_ads_profiles_list") does not find amazon_ads_profiles_list, stop and tell the user to enable Hyper MCP and connect Amazon Ads.

How to run the tools in this skill

Every tool in this skill is named by its canonical tool name. Run it with the call your surface gives you:

Surface Find a tool Run it
MCP client (Claude, Cursor, Codex, ChatGPT) search("<what you want to do>"), then describe("<name>") call("<name>", {...})
Hyper CLI hyperai search "<what you want to do>", then hyperai describe <name> hyperai call <name> --json '{...}'

If a tool is not found, its integration is not connected or not enabled for the workspace: stop and tell the user which integration to connect.

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_profiles_list, amazon_ads_health_check Profile discovery + integration health.
amazon_ads_campaigns_list, amazon_ads_campaigns_create, amazon_ads_campaigns_update Campaign lifecycle.
amazon_ads_ad_groups_create, amazon_ads_product_ads_create Ad group + product ad creation.
amazon_ads_keywords_create, amazon_ads_negative_keywords_create, amazon_ads_campaign_negative_keywords_create Keyword targeting.
amazon_ads_product_targets_create, amazon_ads_negative_product_targets_create Product (ASIN/category) targeting.
amazon_ads_budget_rules_create, amazon_ads_budget_rules_list Budget automation.
amazon_ads_reports_create, amazon_ads_reports_status_get Performance reporting.
amazon_ads_bid_recommendations_get 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.
1---
2name: amazon-ads
3description: Plan and create Amazon Sponsored Products campaigns end-to-end via the Hyper MCP. Use when the user wants to launch Amazon Ads, set up Sponsored Products, manage keyword targeting and bids, configure ASIN or category product targeting, add negative keywords, automate budget rules, analyze ACoS / ROAS, or generate Sponsored Products reports. Also triggers on amazon ppc, amazon campaign, amazon keywords, or amazon report.
4requires_toolkits:
5 - amazon_ads
6icon: amazon_ads
7short_description: Plan and create Amazon Sponsored Products campaigns with targeting and budget rules.
8---
9 
10# Amazon Ads
11 
12Strategic guide for managing Amazon Ads Sponsored Products campaigns. Research first, validate products, optimize for ACoS targets.
13 
14## Requirements
15 
16- **Hyper MCP installed and connected.** [https://app.hyperfx.ai/mcp](https://app.hyperfx.ai/mcp)
17- **Amazon Ads integration connected** at [https://app.hyperfx.ai/apps](https://app.hyperfx.ai/apps).
18 
19If `search("amazon_ads_profiles_list")` does not find `amazon_ads_profiles_list`, stop and tell the user to enable Hyper MCP and connect Amazon Ads.
20 
21### How to run the tools in this skill
22 
23Every tool in this skill is named by its canonical tool name. Run it with the call your surface gives you:
24 
25| Surface | Find a tool | Run it |
26| --- | --- | --- |
27| MCP client (Claude, Cursor, Codex, ChatGPT) | `search("<what you want to do>")`, then `describe("<name>")` | `call("<name>", {...})` |
28| Hyper CLI | `hyperai search "<what you want to do>"`, then `hyperai describe <name>` | `hyperai call <name> --json '{...}'` |
29 
30If a tool is not found, its integration is not connected or not enabled for the workspace: stop and tell the user which integration to connect.
31 
32## Out of scope — defer to other skills
33 
34- **Creative generation** (product imagery, copy) → [`ad-creative-generation`](../ad-creative-generation) / [`image-generation`](../image-generation).
35- **Cross-platform campaign launches** → use this skill for Amazon, then invoke `meta-ads` / `google-ads` separately.
36 
37## Tool surface
38 
39| Tool | Purpose |
40| --- | --- |
41| `amazon_ads_profiles_list`, `amazon_ads_health_check` | Profile discovery + integration health. |
42| `amazon_ads_campaigns_list`, `amazon_ads_campaigns_create`, `amazon_ads_campaigns_update` | Campaign lifecycle. |
43| `amazon_ads_ad_groups_create`, `amazon_ads_product_ads_create` | Ad group + product ad creation. |
44| `amazon_ads_keywords_create`, `amazon_ads_negative_keywords_create`, `amazon_ads_campaign_negative_keywords_create` | Keyword targeting. |
45| `amazon_ads_product_targets_create`, `amazon_ads_negative_product_targets_create` | Product (ASIN/category) targeting. |
46| `amazon_ads_budget_rules_create`, `amazon_ads_budget_rules_list` | Budget automation. |
47| `amazon_ads_reports_create`, `amazon_ads_reports_status_get` | Performance reporting. |
48| `amazon_ads_bid_recommendations_get` | Theme-based bid recommendations. |
49 
50## Critical Rules
51 
52> **CRITICAL**: Keyword, negative keyword, product ad, and product target operations require BOTH `ad_group_id` AND `campaign_id`. Omitting `campaign_id` causes validation errors.
53 
54> **CRITICAL**: Keywords and product targets cannot coexist in the same ad group. Choose one targeting type per ad group.
55 
56> **CRITICAL**: AUTO campaigns only allow negative keywords and negative product targets. Positive keywords and product targets are rejected.
57 
58> **CRITICAL**: Campaign dates use `YYYY-MM-DD` format. Budget rule dates use `YYYYMMDD` format. Do not mix these up.
59 
60> **CRITICAL**: Create campaigns with state `"PAUSED"`. Never launch live without user review.
61 
62> **CRITICAL**: Negative product targets only support `ASIN_SAME_AS` and `ASIN_BRAND_SAME_AS` expressions. Category exclusions are not supported.
63 
64> **CRITICAL**: All enum values must be UPPERCASE: `PAUSED`, `ENABLED`, `BROAD`, `PHRASE`, `EXACT`, `NEGATIVE_EXACT`, `NEGATIVE_PHRASE`, `MANUAL`, `AUTO`.
65 
66> **IMPORTANT**: Portfolio operations return 404 for vendor accounts. Use campaign-level management instead.
67 
68> **IMPORTANT**: Budget rule listing may return empty even after successful creation. Track rule IDs from creation responses.
69 
70> **IMPORTANT**: All budgets are in dollars (not cents, not micros). $25 daily budget = `25`.
71 
72## Core process
73 
74Discovery → 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.
75 
76> **All reference files live in `references/`.** Read them at `references/<file>` (e.g. `references/discovery.md`).
77 
78## Routing table
79 
80| The user wants to… | Read these files first |
81|---|---|
82| Launch a Sponsored Products campaign | [references/discovery.md](references/discovery.md) → [references/campaign-creation.md](references/campaign-creation.md) |
83| Add keywords / negatives / product targets to an existing campaign | [references/campaign-creation.md](references/campaign-creation.md) |
84| Automate budgets (schedule or performance rules) | [references/budget-rules.md](references/budget-rules.md) |
85| Analyze performance / ACoS / search terms | [references/reporting.md](references/reporting.md) |
86| Get bid recommendations | [references/reporting.md](references/reporting.md) |
87| Work across marketplaces (multi-profile) | [references/reporting.md](references/reporting.md) |
88| Goal not yet clear | [references/discovery.md](references/discovery.md) — discovery clarifies the goal |
89 
90## Campaign Statuses
91 
92- `PAUSED`: Created but not live (safe default).
93- `ENABLED`: Running and spending budget.
94- `ARCHIVED`: Deleted (cannot be restored).
95 
96## Known Limitations
97 
98| Issue | Workaround |
99| --- | --- |
100| Portfolio operations return 404 (vendor) | Use campaign-level grouping + naming conventions. |
101| Budget rule listing may return empty | Track rule IDs from creation responses. |
102| Category recommendations may fail (500) | Use manual research or dashboard. |
103 
104## Safety Rules
105 
106**Never:**
107- Assume ASINs or keywords — always ask.
108- Skip the research/audit phase.
109- Create campaigns without explicit approval.
110- Set campaigns to ENABLED without user consent.
111- Ignore ACoS targets when recommending bids.
112- Add products the user hasn't confirmed.
113- Mix keywords and product targets in the same ad group.
114- Omit `campaign_id` from keyword/product operations.
115 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 90
Checked
Source
hyperfx-ai/marketing-skills ↗
Creator
hyperfx-ai · 11 listings
View creator

Similar skills

See all →
SkillGenerate, iterate, or scale ad creativecoreyhaines31/marketingskills · by coreyhaines31When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' 'static ads,' 'ad templates,' 'iMessage ad,' 'chat reveal ad,' 'ChatGPT ad,' 'Apple Notes ad,' 'AirDrop ad,' 'creative strategy,' 'creative roadmap,' 'creative retro,' 'hook writing,' 'creative review page,' 'present ad creative for approval,' 'motion video ad,' 'faceless video ad,' 'UGC ad,' 'greenscreen ad,' 'TikTok/Reels ad format,' 'which ad format to make,' 'Meta ad format tier list,' or 'creative format taxonomy.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see ads. For landing page copy, see copywriting.★ 51.1k GitHub starsSkillYou share your Amazon advertising numbers and goals; you getAmazon Ads AuditAgriciDaniel/claude-ads · by AgriciDanielYou share your Amazon advertising numbers and goals; you get back a plain-language review of what's draining your budget and what to change first.★ 9.5k GitHub starsSkillPaste what you're spending on Apple Search AdsApple Ads AuditAgriciDaniel/claude-ads · by AgriciDanielPaste what you're spending on Apple Search Ads and your recent numbers; get back a plain review of what's wasting money and what to fix first.★ 9.5k GitHub starsSkillPlan and review Amazon Ads with margin-aware ACoS, productAmazon Ads Planningnowork-studio/notfair-plugin · by nowork-studioPlan and review Amazon Ads with margin-aware ACoS, product, and search-term guardrails. Use for Amazon advertising, Sponsored Products, Sponsored Brands, Sponsored Display, ASIN targeting, Amazon ACoS, or Amazon Ads performance exports.★ 3.9k GitHub starsSkillAct as the advertising engine for /market ads <urlAd Creative & Copy Generationzubair-trabzada/ai-marketing-claude · by zubair-trabzadaYou are the advertising engine for /market ads <url>. You generate complete ad campaigns across platforms with full copy variations,…★ 2.7k GitHub starsSkillLinkedIn Ads management skill for B2B SaaS campaignsivangfalco/ads-skills · by ivangfalcoLinkedIn Ads management skill for B2B SaaS campaigns. Routes to specialized sub-skills for campaign planning, performance analysis, account audits, and account management. MANDATORY TRIGGERS: LinkedIn Ads, LinkedIn campaign, LinkedIn advertising, B2B ads, paid social, LinkedIn paid, ad account, campaign manager, LinkedIn lead gen, LinkedIn retargeting, ad audit, ad performance, ad optimization, campaign plan, media plan, LinkedIn budget★ 275 GitHub stars

More from hyperfx-ai

SkillGenerate on-brand ad creativesAd creative generationhyperfx-ai/marketing-skills · by hyperfx-aiGenerate on-brand ad creatives — visuals + copy — for Google, Meta (Facebook / Instagram), and other paid platforms via the Hyper MCP. Extracts brand identity from a website, writes ad copy variants, and produces brand-consistent images using reference-based image generation. Use when the user asks for ad creative, ad copy variants, RSA headlines, Meta ad creative, display ads, carousel ads, or A/B test variants.★ 90 GitHub starsSkillRun end-to-end B2B cold-email outreach through the Hyper MCPhyperfx-ai/marketing-skills · by hyperfx-aiRun end-to-end B2B cold-email outreach through the Hyper MCP — enrich prospects with Apollo, scrape per-prospect signals from company sites and LinkedIn, draft personalized emails using proven hook frameworks, send via Gmail with safe defaults, and route replies into labeled folders. Use when the user wants to write cold emails, run an outbound sequence, prospect a list, build a follow-up cadence, "reach out to leads," or asks why nobody is replying to their cold emails.★ 90 GitHub starsSkillPlan and create new Google Ads campaignshyperfx-ai/marketing-skills · by hyperfx-aiPlan and create new Google Ads campaigns and report on existing accounts via the Hyper MCP. Use when the user wants to launch Search, Display, Performance Max, Video, Demand Gen, Shopping, or App campaigns, build Google Ads reports or dashboards, diagnose conversion tracking, or mentions Google Ads, AdWords, search ads, display ads, Performance Max, PMax, PPC, Google campaigns, search term reports, budget analysis, conversion funnels, negative keywords, or manager accounts (MCC).★ 90 GitHub starsSkillManage Instagram professional accounts via the Hyper MCPhyperfx-ai/marketing-skills · by hyperfx-aiManage Instagram professional accounts via the Hyper MCP — publish photos, Reels, Stories, and carousels; moderate comments and mentions; send Direct Messages; pull account and media insights. Uses the Instagram API with Instagram Login (Business Login). Use when the user mentions Instagram posts, Reels, Stories, carousels, IG DMs, Instagram comments, mentions, profile, or analytics. For paid Instagram advertising, use `meta-ads`.★ 90 GitHub starsSkillPublish and manage LinkedIn content via the Hyper MCPhyperfx-ai/marketing-skills · by hyperfx-aiPublish and manage LinkedIn content via the Hyper MCP — text posts, article / link previews, document and PDF posts, organization (company page) posts, and AI-generated text-to-carousel posts. Use when the user wants to post on LinkedIn, share an article on LinkedIn, post to a LinkedIn company page, upload a PDF / document to LinkedIn, or build a LinkedIn carousel from text.★ 90 GitHub starsSkillPlan and create Meta advertising campaigns end-to-endMeta adshyperfx-ai/marketing-skills · by hyperfx-aiPlan and create Meta (Facebook + Instagram) advertising campaigns end-to-end via the Hyper MCP, defaulting to Advantage+ automation. Use when the user wants to launch Meta ads, Facebook ads, Instagram ads, Advantage+ campaigns, carousel ads, dynamic creative ads, set up Meta conversion tracking, analyze performance, audit a Meta ads account, or build Meta performance dashboards. Also triggers on phrases like meta campaign, facebook campaign, advantage+, or meta account audit.★ 90 GitHub stars