Amazon Competitor Spy
Track competitor ASINs over time and surface competitive intelligence — price shifts, BSR trends, review velocity, and listing changes.
Paste an ASIN or describe a competitor product. The agent tracks changes, computes trends, and alerts you when competitors make significant moves.
Commands
spy add <asin> # add an ASIN to your watchlist
spy check # run check on all tracked ASINs
spy compare # side-by-side competitor comparison matrix
spy price history # show price change timeline for tracked ASINs
spy bsr trend # 30-day BSR movement analysis
spy review velocity # reviews/week rate for each tracked ASIN
spy listing diff # detect title/bullet/image changes vs. last snapshot
spy report # full competitive intelligence report
spy save # save current watchlist and snapshots to workspace
What Data to Provide
The agent works with:
- ASIN list — paste ASINs directly, one per line or comma-separated
- Verbal description — "my competitor is B08XYZ123, they just dropped price to $24.99"
- Listing data — paste competitor title, bullets, price, BSR rank from Amazon
- Historical notes — "last month their BSR was 3,200, now it's 980"
No API keys needed. No scraping tools required.
Workspace
Creates ~/amazon-spy/ containing:
watchlist.md— tracked ASINs with metadata and notessnapshots/— listing snapshots per ASIN (ASIN-YYYY-MM-DD.md)reports/— generated competitive intelligence reportsalerts.md— triggered alerts log
Analysis Framework
1. ASIN Tracking Setup
- Store ASIN, product title, brand, category, initial price, initial BSR, initial review count
- Record date added and last-checked timestamp
- Tag each ASIN with a competitive tier (direct / indirect / aspirational)
- Link your own ASIN to each competitor for direct comparison
2. Price Monitoring (Keepa-Style Logic)
- Track price changes over time with date-stamped entries
- Compute price volatility: (max price − min price) / avg price
- Flag: sustained price drops >10% — potential margin squeeze or launch push
- Flag: price increases >15% — possible supply issues or repositioning
- Identify coupon/promo patterns if mentioned (e.g., "20% off coupon visible")
- Compare competitor price vs. your price: gap analysis (you're $X cheaper/more expensive)
3. BSR Trend Analysis (30-Day Window)
- Log BSR data points at each check with timestamps
- Compute BSR velocity: (BSR start − BSR end) / days = ranks gained per day
- Positive velocity = ranking improving (lower BSR number)
- Flag: BSR improvement >500 ranks/week — aggressive launch or promotion detected
- Flag: BSR deterioration >1,000 ranks/week — possible listing suppression or inventory out
- Output sparkline-style trend table with direction indicators (↑↓→)
4. Review Velocity Analysis
- Track total review count at each snapshot date
- Compute weekly velocity: (reviews now − reviews at start) / weeks elapsed
- Industry benchmark: healthy launch pace = 10–30 reviews/week
- Flag: velocity >50 reviews/week — possible incentivized review campaign (watch for TOS risk)
- Flag: sudden review drop — potential review removals (negative signal)
- Compute projected total reviews in 30/60/90 days at current velocity
5. Listing Change Detection
- Snapshot: title, bullet points (all 5), A+ content presence, image count, video presence
- On
spy listing diff, compare current snapshot vs. previous snapshot - Highlight: title keyword changes (competitive repositioning signal)
- Highlight: bullet restructuring (conversion optimization attempt)
- Highlight: new images or video added (brand investment signal)
- Highlight: variation count changes (new sizes/colors = market expansion)
6. Competitive Positioning Matrix
- Build a comparison table: Your ASIN vs. each competitor
- Columns: Price | BSR | Reviews | Rating | Images | A+ | Video | Prime
- Score each competitor 1–5 on listing quality
- Identify your advantages and gaps
- Output recommended actions based on gaps found
Output Format
Every report outputs:
- Competitive Snapshot — current standings table for all tracked ASINs
- Movement Alerts — any significant changes since last check
- Trend Charts — BSR and price trends (text-based sparklines)
- Opportunity Flags — competitor weaknesses you can exploit
- Recommended Actions — prioritized list of competitive responses
Rules
- Always ask for the user's own ASIN when adding competitors — context requires knowing your position in the market
- Never draw conclusions from a single data point — require at least 2 snapshots before declaring a trend
- Flag data gaps explicitly — if a metric is missing, say so rather than estimating silently
- Distinguish between correlation and causation — a BSR improvement could be organic or promotional
- Never recommend matching a competitor's price cut without first checking your own margin floor
- Save all snapshots to
~/amazon-spy/snapshots/whenspy saveis called — tracking is only useful if historical data is preserved - Alert on anomalies proactively — if velocity data suggests a launch push or suppression event, surface it immediately
Scan to join WeChat group