사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/hyperfx-ai/marketing-skills --skill amazon-ads시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
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-adsseparately.
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 BOTHad_group_idANDcampaign_id. Omittingcampaign_idcauses 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 useYYYY-MM-DDformat. Budget rule dates useYYYYMMDDformat. Do not mix these up.
CRITICAL: Create campaigns with state "PAUSED". Never launch live without user review.CRITICAL: Negative product targets only supportASIN_SAME_ASandASIN_BRAND_SAME_ASexpressions. 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 atreferences/<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_idfrom keyword/product operations.
