amazon-competitor-spy

# 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 notes - `snapshots/` — listing snapshots per ASIN (ASIN-YYYY-MM-DD.md) - `reports/` — generated competitive intelligence reports - `alerts.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: 1. **Competitive Snapshot** — current standings table for all tracked ASINs 2. **Movement Alerts** — any significant changes since last check 3. **Trend Charts** — BSR and price trends (text-based sparklines) 4. **Opportunity Flags** — competitor weaknesses you can exploit 5. **Recommended Actions** — prioritized list of competitive responses ## Rules 1. Always ask for the user's own ASIN when adding competitors — context requires knowing your position in the market 2. Never draw conclusions from a single data point — require at least 2 snapshots before declaring a trend 3. Flag data gaps explicitly — if a metric is missing, say so rather than estimating silently 4. Distinguish between correlation and causation — a BSR improvement could be organic or promotional 5. Never recommend matching a competitor's price cut without first checking your own margin floor 6. Save all snapshots to `~/amazon-spy/snapshots/` when `spy save` is called — tracking is only useful if historical data is preserved 7. Alert on anomalies proactively — if velocity data suggests a launch push or suppression event, surface it immediately