Skill: ivangdavila/amazon (version 1.0.1)

--- name: Amazon slug: amazon version: 1.0.1 description: Navigate Amazon as buyer, seller, or affiliate with price tracking, listing optimization, and smart purchasing decisions. metadata: {"clawdbot":{"emoji":"📦","requires":{"bins":[]},"os":["linux","darwin","win32"]}} --- ## Quick Reference | File | Purpose | |------|---------| | `buying.md` | Smart purchasing, comparisons, reorders | | `pricing.md` | Price tracking, deal detection, timing | | `selling.md` | FBA/FBM operations, listing optimization | | `affiliates.md` | Amazon Associates, commission optimization | | `security.md` | Credentials, payments, account safety | | `legal.md` | ToS compliance, automation limits | ## What the Agent Does | User Request | Agent Action | |--------------|--------------| | "Find best X under $Y" | Search, compare reviews/ratings/price history, recommend | | "Track price of [product]" | Monitor, alert on drops, suggest buy timing | | "Reorder my [consumable]" | Find previous order, check price vs last time, reorder | | "Is this deal real?" | Check price history, detect inflated-then-discounted | | "Compare [A] vs [B]" | Side-by-side specs, reviews sentiment, value analysis | | "Help me sell [product]" | Listing optimization, keyword research, pricing strategy | | "Generate affiliate link" | Create tagged link, track performance | ## Buyer Mode — Core Capabilities **Product research:** - Search with filters (price, rating, Prime, seller type) - Aggregate reviews — summarize pros/cons, detect fake patterns - Compare alternatives with feature matrix - Check seller reputation (third-party risk assessment) **Price intelligence:** - Track historical prices (detect fake discounts) - Alert on price drops to target - Identify best time to buy (Prime Day, Black Friday patterns) - Compare across Amazon regions when applicable **Purchasing:** - Add to cart, apply coupons/Subscribe & Save - Reorder recurring items with price verification - Gift purchases with delivery coordination - Returns/refunds initiation See `buying.md` for detailed workflows. ## Seller Mode — Core Capabilities **Listing management:** - Create/optimize product listings - Keyword research for search visibility - A+ Content recommendations - Image requirements compliance **Operations:** - Inventory monitoring and restock alerts - FBA shipment planning - Pricing vs competition tracking - Review monitoring and response drafts **Analytics:** - Sales velocity, conversion rates - Advertising performance (PPC) - Profit margin calculation (fees, shipping, returns) See `selling.md` for seller workflows. ## Affiliate Mode — Core Capabilities **Link management:** - Generate affiliate links with proper tags - Shorten/customize for platforms - Track click-through and conversions **Content optimization:** - High-commission product categories - Seasonal trending products - Comparison content ideas See `affiliates.md` for affiliate strategies. ## Critical Security Rules **Credentials — NEVER:** - Store Amazon password in plain text - Share session cookies across devices - Bypass 2FA prompts **Payments — ALWAYS:** - Confirm total before purchase - Verify shipping address - Alert on unusual amounts **Automation — LIMITS:** - Rate limit all requests (avoid account flags) - No automated purchasing without human confirmation - Respect session timeouts See `security.md` for complete security protocols. ## Legal Constraints **Automation boundaries:** - Amazon ToS prohibits certain bots — know the limits - Affiliate disclosure required on all monetized content - Seller account actions need manual confirmation **What's allowed:** - Price tracking via public pages - Affiliate link generation - Listing optimization assistance **What requires caution:** - Automated purchasing (needs explicit user auth flow) - Review analysis at scale (rate limits) - Scraping product data (use official APIs when available) See `legal.md` for ToS details and safe practices.

path: affiliates.md
content: # Amazon Associates

## Link Generation

**Standard affiliate link format:**
```
https://www.amazon.com/dp/[ASIN]?tag=[your-tag]
```

**Shortened format:**
```
https://amzn.to/[short-code]
```
Use Amazon's link shortener from Associates dashboard.

## Commission Tiers

**Higher commission categories (typically 4-10%):**
- Amazon Games
- Luxury Beauty
- Luxury Stores Fashion
- Digital Music
- Physical Books

**Lower commission categories (1-3%):**
- Electronics
- Computers
- TV & Video
- Video Games (physical)

**Strategy:** Guide content toward higher-commission categories when authentic.

## Disclosure Requirements

**FTC mandates clear disclosure:**
- "As an Amazon Associate, I earn from qualifying purchases"
- Must be visible BEFORE affiliate links
- Not buried in footer — near content with links

**Platform-specific:**
- YouTube: Verbal + description
- Blog: Header or inline before first link
- Social: In post, not just bio

## Content Strategies

**What converts:**
- Comparison posts ("X vs Y")
- Best-of lists ("Best Z under $100")
- Problem-solution ("How to fix X")
- Reviews with real usage

**What doesn't convert:**
- Generic product dumps
- Outdated recommendations
- Products you haven't used/researched
- Over-linking (every word a link)

## Tracking & Optimization

**Key metrics:**
- Click-through rate by content/placement
- Conversion rate by product category
- Earnings per click
- Bounce products (clicked but not bought)

**Optimization tactics:**
- Test link placement (inline vs buttons)
- Update old posts with current prices
- Remove discontinued products
- Seasonal content refresh

## Common Violations (Account Risk)

**Don't do:**
- Cloaking links
- Incentivizing clicks ("click here for surprise")
- Using links in email (prohibited)
- Masking affiliate nature
- Links in PDFs (often prohibited)

**Safe practices:**
- Clear disclosure every time
- Links only on approved platforms
- No price guarantees (prices change)
- Update content quarterly minimum


path: buying.md
content: # Buying Workflows

## Product Research Process

1. **Understand need** — What problem? Budget? Timeline?
2. **Initial search** — Broad terms, note top categories
3. **Filter ruthlessly** — Prime, rating ≥4.0, price range
4. **Deep-dive top 3** — Full review analysis, Q&A section
5. **Price check** — Is current price good historically?
6. **Recommend** — One pick with reasoning, alternatives noted

## Review Analysis — Detecting Real Quality

**Red flags for fake reviews:**
- Burst of 5-star reviews in short period
- Generic praise without specific product details
- Reviewer has only reviewed products from one brand
- "I received this product for free" disclaimers
- Broken English with excessive enthusiasm

**Finding real signal:**
- Focus on 3-4 star reviews (balanced perspectives)
- Look for verified purchases
- Check reviewer history (real people buy diverse products)
- Read the negative reviews — are complaints about the product or shipping?

## Comparison Framework

When comparing products, build matrix:

| Factor | Product A | Product B | Weight |
|--------|-----------|-----------|--------|
| Price | $X | $Y | High |
| Rating | 4.3 (2k) | 4.5 (500) | Medium |
| Key feature | Has X | Missing X | Critical |
| Warranty | 2 year | 1 year | Low |

Weight factors by user priority. Don't just pick highest rating — context matters.

## Reorder Workflow

1. **Find previous order** — Order history, identify exact product
2. **Check current price** — Compare to what was paid
3. **Price changed?** — Alert if >10% increase
4. **Subscribe & Save** — Suggest if recurring (usually 5-15% off)
5. **Confirm** — Show total, delivery estimate, get approval
6. **Execute** — Place order, confirm order number

## Consumables Management

Track recurring purchases:
- Estimated depletion date based on last order interval
- Proactive reminder before running out
- Price watch for deals before scheduled reorder

## Deal Evaluation

Before recommending a "deal":

1. **Check price history** — Was it this price 2 weeks ago?
2. **Calculate real discount** — From typical price, not "list price"
3. **Lightning deal?** — Time pressure real or artificial?
4. **Coupon stacking** — Any applicable coupons?
5. **Subscribe & Save** — Often beats "sale" price

**Never trust:**
- "List price" claims (often inflated)
- "X% claimed" percentages
- Lightning deal urgency alone


path: legal.md
content: # Legal & Compliance

## Amazon Terms of Service — Key Restrictions

**Prohibited automation:**
- Bots that click/interact as if human without disclosure
- Automated purchasing without proper auth flow
- Scraping at scale without API license
- Circumventing CAPTCHAs or bot detection

**Gray areas (proceed with caution):**
- Price monitoring (ok at reasonable rate)
- Review aggregation (public data, rate-limited)
- Wishlist management (personal account only)

**Explicitly allowed:**
- Using Product Advertising API (with credentials)
- SP-API for sellers (with seller credentials)
- Affiliate link generation (Associates program)
- Manual operations assisted by AI

## Affiliate Compliance

**FTC requirements:**
- Clear, conspicuous disclosure
- Before consumer interacts with links
- "Material connection" must be stated

**Amazon Associates Operating Agreement:**
- No links in email/SMS/offline materials
- No misleading claims about products
- No fake urgency ("only 2 left!" if not true)
- No price claims (prices change without notice)

**Consequences of violation:**
- Commission clawback
- Account termination
- Ban from program (permanent)

## Seller Compliance

**Restricted activities:**
- Review manipulation (asking for positive reviews)
- Fake orders to inflate sales rank
- Keyword stuffing with competitor brands
- Buying own products for reviews

**Intellectual property:**
- Don't use trademarked terms unless authorized
- Images must be owned or licensed
- No copying competitor listing content

**Account health:**
- Policy violations accumulate
- Account suspension can be permanent
- Appeals process exists but difficult

## Data & Privacy

**User data handling:**
- Don't collect more than needed
- Secure storage required
- GDPR/CCPA compliance if applicable
- No selling/sharing purchase history

**API terms:**
- Data from APIs has usage restrictions
- Can't build competing product database
- Attribution required in some cases

## Jurisdictional Differences

**US (amazon.com):**
- FTC guidelines apply
- State tax nexus considerations
- CCPA for California users

**EU (amazon.de, .fr, .co.uk, etc.):**
- GDPR consent requirements
- VAT handling for sellers
- Different affiliate commission structures
- Cookie consent requirements

**Best practice:**
- Default to strictest jurisdiction rules
- Localize disclosures by market
- Consult local regs for selling

## Safe Automation Patterns

**Do:**
- Use official APIs when available
- Implement rate limiting
- Log all automated actions
- Require human confirmation for transactions

**Don't:**
- Impersonate human browsing
- Scale beyond personal use without APIs
- Automate anything TOS explicitly prohibits
- Store credentials in code or plain text


path: pricing.md
content: # Price Tracking & Deal Detection

## Price History Analysis

**What to check:**
- 90-day price range (typical fluctuation)
- 1-year low/high (absolute range)
- Pre-Prime Day prices (baseline for "deals")
- Black Friday/Cyber Monday patterns

**Tools/approaches:**
- CamelCamelCamel for historical data
- Keepa charts embedded in product pages
- Build own tracking for key products

## Fake Discount Detection

**Pattern: Inflate then discount**
- Price raised 2-4 weeks before sale
- "50% off" from inflated price
- Real discount: 10-15% from typical

**How to catch:**
- Compare to 90-day average, not "was" price
- Check if product is actually popular at claimed "original" price
- Look for review velocity — did sales match "original" price claims?

## Optimal Buy Timing

**Predictable sales:**
- Prime Day (July) — electronics, Amazon devices
- Black Friday/Cyber Monday — everything
- Back to school (August) — laptops, supplies
- Spring deals — home/garden

**Category patterns:**
- TVs: Best prices Nov-Dec, new models Jan (old models clearance)
- Laptops: Back to school, Black Friday
- Amazon devices: Prime Day (best), Black Friday
- Clothing: Season-end clearance (60-70% off)

## Price Alert System

Set alerts with context:

```
Product: [ASIN]
Target: $X (Y% below current)
Alert type: 
  - Any drop
  - Target price
  - All-time low
Expiry: [date or "ongoing"]
```

## Subscribe & Save Math

Calculate if worth it:

```
Regular price: $X
S&S discount: Y% (typically 5-15%)
S&S price: $X * (1 - Y/100)
Additional coupons: Often stack

Compare to:
- Deal price frequency
- Price per unit optimization
- Delivery flexibility needed
```

S&S wins for true consumables. Skip for items with frequent sales that beat S&S.

## Multi-Region Arbitrage

When applicable:
- Compare Amazon US/UK/DE prices
- Factor shipping and import duties
- Check warranty validity across regions
- Note: Many products region-locked


path: security.md
content: # Security Protocols

## Credential Handling

**Storage rules:**
- NEVER store Amazon password in agent memory
- Use OS keychain/secrets manager for any stored credentials
- Session tokens expire — don't persist indefinitely
- 2FA codes are one-time — never cache

**Authentication flow:**
- Agent initiates login context
- Human enters credentials directly to Amazon
- Agent receives session (not credentials)
- Session has limited scope and duration

## Payment Security

**Before any purchase:**
- Display full total including tax/shipping
- Show payment method to be charged
- Confirm shipping address
- Wait for explicit human approval

**Never automate:**
- Adding new payment methods
- Changing default payment
- One-click purchases (too risky)
- Gift card redemption

**Red flags to catch:**
- Price significantly different from expected
- Unusual shipping address
- High-value purchase from new seller
- Multiple orders in short period

## Account Protection

**Monitor for:**
- Unrecognized devices in security settings
- Failed login attempts
- Order confirmation for things not ordered
- Address changes not initiated by user

**If compromise suspected:**
- Change password immediately
- Review and end all sessions
- Check for unauthorized orders
- Enable/verify 2FA

## Automation Safety

**Rate limiting:**
- Don't hammer Amazon with requests
- Implement exponential backoff on errors
- Spread operations across time

**Session management:**
- Respect session timeouts
- Re-authenticate cleanly when expired
- Don't force session extension

**Seller account specifics:**
- Higher security — linked to bank accounts
- More aggressive bot detection
- API keys where available (Product Advertising API, SP-API)

## Data Protection

**Don't store:**
- Full credit card numbers
- Amazon account passwords
- Social security / tax IDs
- Bank routing numbers

**OK to store:**
- Order history summaries
- Product watchlists (ASINs)
- Price history data
- Non-sensitive preferences

## Phishing Awareness

**Common Amazon phishing patterns:**
- "Your order couldn't be shipped"
- "Account locked — verify now"
- "You won a prize"
- "Unusual sign-in detected" (ironic)

**Always verify:**
- Check sender domain carefully
- Don't click links — go to Amazon directly
- Amazon never asks for password via email
- When in doubt, check order history directly


path: selling.md
content: # Seller Operations

## Listing Optimization

**Title formula:**
```
[Brand] [Product] [Key Feature] [Size/Quantity] [Color/Variant]
```
- 200 characters max
- Front-load important keywords
- No promotional language ("best", "top-rated")

**Bullet points:**
- 5 bullets, each 200-250 characters
- Start with benefit, support with feature
- Include keywords naturally
- Address top customer questions

**Backend keywords:**
- 250 bytes limit
- No repetition of title words
- Include misspellings, synonyms
- No competitor brand names (TOS violation)

## FBA vs FBM Decision

| Factor | FBA Better | FBM Better |
|--------|------------|------------|
| Volume | High, consistent | Low or variable |
| Size | Standard, lightweight | Oversized, heavy |
| Margins | Can absorb fees | Tight margins |
| Prime | Required for category | Less important |
| Control | Less needed | Returns handling critical |

## Inventory Management

**Restock triggers:**
- 30-day supply threshold (adjustable)
- Lead time buffer (supplier → Amazon)
- Seasonal demand spikes planned

**Stockout prevention:**
- FBA storage limits check before shipping
- Split shipments risk assessment
- IPI score monitoring

**Overstock problems:**
- Long-term storage fees (after 365 days)
- Aged inventory surcharge
- Liquidation vs removal decision

## Pricing Strategy

**Competitive pricing:**
- Track Buy Box winner price
- Factor in shipping for FBM competitors
- Don't race to bottom — consider margin floors

**Dynamic pricing rules:**
- Match competitor floor (with min margin)
- Reduce aged inventory gradually
- Seasonal adjustments automated

## Review Management

**Soliciting reviews (TOS compliant):**
- Use "Request a Review" button (official)
- Amazon Vine for new products (paid program)
- Product inserts: thank + support info only (no review solicitation)

**Responding to negatives:**
- Acknowledge issue professionally
- Offer resolution path
- Don't argue, don't offer compensation in public
- Fix root cause if pattern emerges

## Hijacker Detection

**Signs of hijacking:**
- Sudden negative reviews about "wrong product"
- Price dramatically undercut by unknown seller
- Buy Box lost to new seller

**Response:**
- Test buy to document
- Report to Amazon with evidence
- Brand Registry for ongoing protection

## PPC Advertising Basics

**Campaign types:**
- Sponsored Products: Product-level, keyword targeting
- Sponsored Brands: Brand awareness, headline search
- Sponsored Display: Retargeting, competitor targeting

**Optimization:**
- Start auto campaigns, harvest converting keywords
- Negative exact match for wasted spend
- ACoS targets by product lifecycle stage


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)