amazon-sales-estimator

# Amazon Sales Estimator 📊

Estimate monthly sales from BSR, analyze market size, and benchmark competitor performance. No API key — works out of the box.

## Installation

```bash
npx skills add nexscope-ai/Amazon-Skills --skill amazon-sales-estimator -g
```

## Three Modes

| Mode | When to Use | Input | Output |
|------|-------------|-------|--------|
| **A — BSR Calculator** | Quick estimate from known BSR | BSR + Marketplace + Price + Category | Monthly units, monthly revenue |
| **B — ASIN Lookup** | Estimate sales for a specific product | ASIN or product URL | Auto-fetch data + sales estimate |
| **C — Keyword Market Analysis** | Size a niche opportunity | Keyword (+ optional marketplace) | Total market sales, top sellers, price distribution |

## Capabilities

- **BSR-to-sales conversion**: Estimate monthly unit sales from Best Seller Rank using category-specific formulas
- **Revenue calculation**: Monthly sales × price = estimated monthly revenue
- **Market sizing**: Aggregate sales across products in a keyword search
- **Price band analysis**: Distribution of sales across price ranges
- **Competition breakdown**: Top sellers vs long-tail distribution
- **Multi-marketplace**: US, UK, DE, FR, IT, ES, JP, CA, AU, IN, MX, BR

## Handling Incomplete Input

If the user's intent is unclear or information is missing, guide them with all options and required inputs upfront:

**User says:** `"Help me estimate Amazon sales"` or `"I want to check sales"`

**Agent should respond:**

> I can help you estimate Amazon sales in 3 ways. Pick one and provide the required info:
>
> **A. BSR Calculator** — Quick estimate from BSR number
> - BSR (required): e.g., 1500
> - Category (required): e.g., Home & Kitchen
> - Price (required): e.g., $24.99
> - Marketplace (optional, default US)
>
> **B. ASIN Lookup** — Check sales for a specific product
> - ASIN or URL (required): e.g., B09V3KXJPB
> - Marketplace (optional, default US)
>
> **C. Market Analysis** — Size a keyword/niche opportunity
> - Keyword (required): e.g., "yoga mat"
> - Marketplace (optional, default US)
> - Filters (optional): price range, min reviews
>
> Example: "Mode A: BSR 1500, Home & Kitchen, $24.99" or "Mode B: B09V3KXJPB"

---

## Mode A — BSR Calculator

### Input

| Field | Required | Description | Example |
|-------|----------|-------------|---------|
| **BSR** | ✅ | Best Seller Rank number | 1500 |
| **Marketplace** | ✅ | Amazon site | US, UK, DE, JP... |
| **List Price** | ✅ | Product price | $24.99 |
| **Category** | ✅ | Product category | Home & Kitchen |

### Usage Examples

```
Estimate sales for BSR 1500 in Home & Kitchen on Amazon US, price $24.99
```

```
BSR 500, category Electronics, marketplace DE, price €39.99
```

```
What's the monthly sales for a product ranked #10,000 in Sports & Outdoors at $15.99?
```

### Workflow

1. **Receive input**: BSR, Category, Price, Marketplace
2. **Look up base sales**: Use BSR-to-sales reference table for the marketplace
3. **Apply category multiplier**: Adjust based on category (Electronics 1.2x, Clothing 0.8x, etc.)
4. **Calculate monthly units**: Base sales × category multiplier
5. **Calculate revenue**: Monthly units × price
6. **Output results**: Monthly units, daily units, monthly revenue

### Output

```
# 📊 Sales Estimate

**Input:**
- BSR: #1,500 in Home & Kitchen
- Marketplace: Amazon US
- Price: $24.99

**Results:**

| Metric | Estimate |
|--------|----------|
| **Est. Monthly Units** | ~450 units |
| **Est. Monthly Revenue** | ~$11,246 |
| **Est. Daily Units** | ~15 units |

*Estimate based on BSR-to-sales conversion formula for the selected category and marketplace.*
```

---

## Mode B — ASIN Lookup

### Input

| Field | Required | Description | Example |
|-------|----------|-------------|---------|
| **ASIN** | ✅ | Amazon product ID or URL | B09V3KXJPB |
| **Marketplace** | Optional | Defaults to US | UK, DE, JP... |

### Usage Examples

```
Estimate monthly sales for ASIN B09V3KXJPB
```

```
How many units does this sell? https://www.amazon.com/dp/B0D72TSM62
```

```
Get sales estimate for B0CPY1GFVZ on Amazon DE
```

### Workflow

1. **Fetch product data** using `web_fetch` on Amazon product page
2. **Extract**: Title, Price, BSR, Category, Rating, Reviews
3. **Apply BSR-to-sales formula** for the category and marketplace
4. **Calculate revenue**: Monthly units × Price

### Output

```
# 📊 Sales Estimate: B09V3KXJPB

## Product Info
- **Title:** [Product Title]
- **Price:** $24.99
- **BSR:** #1,500 in Home & Kitchen
- **Rating:** 4.5★ (1,234 reviews)

## Sales Estimate

| Metric | Estimate |
|--------|----------|
| **Est. Monthly Units** | ~450 units |
| **Est. Monthly Revenue** | ~$11,246 |
| **Est. Daily Units** | ~15 units |

## Competitive Context
- Ranks in **top 0.5%** of Home & Kitchen category
- Above average for $20-30 price range
```

---

## Mode C — Keyword Market Analysis

### Input

| Field | Required | Description | Example |
|-------|----------|-------------|---------|
| **Keyword** | ✅ | Search term | yoga mat |
| **Marketplace** | Optional | Amazon site (default: US) | UK, DE, JP... |
| **Filters** | Optional | Price range, min reviews | $15-$40, 100+ reviews |

### Usage Examples

```
Analyze the market size for "yoga mat" on Amazon US
```

```
What's the total monthly sales for "portable blender" keyword?
```

```
Size the "dog shirt" market on Amazon US. Show top sellers and price distribution.
```

### Workflow

1. **Search products** using `web_search` for `site:amazon.com "{keyword}"`
2. **Fetch top 10-20 product pages** to get BSR data
3. **Estimate sales for each product** using Mode A formula
4. **Aggregate** total market size
5. **Analyze** price distribution and competition

### Output

```
# 📊 Market Analysis: "yoga mat"

**Marketplace:** Amazon US | **Products Analyzed:** 25

## Market Size

| Metric | Value |
|--------|-------|
| **Est. Total Monthly Units** | ~85,000 units |
| **Est. Total Monthly Revenue** | ~$2.1M |
| **Av