---
name: taobao
description: "淘宝/天猫商品搜索和选品调研。当用户需要搜索淘宝商品（淘宝搜索/搜淘宝/天猫搜索）、查看淘宝商品详情（淘宝商品/天猫商品/商品详情）、查看商品评论（淘宝评论/买家评价/用户评价）、分析淘宝商品（商品分析/选品/国内电商）、或做淘宝市场调研（淘宝市场/天猫市场/国内市场）时使用此技能。"
---

# 淘宝/天猫 - 商品搜索与选品调研

所有命令使用 `scout taobao` 前缀。数据源：JustOneAPI（¥0.15/次）。

---

## 快速选择：我该用哪个命令？

| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
|---------|---------|---------|---------|
| **搜索商品** | `search "关键词"` | — | 按关键词搜索淘宝/天猫 |
| **了解某个商品** | `detail <itemId>` | `comments` | 详情→评论 |
| **商品完整分析** | `insights <itemId>` | — | 一键获取详情+评论 |
| **只看评论** | `comments <itemId>` | — | 买家评价分析 |
| **找天猫商品** | `search "关键词" --tmall` | — | 只搜天猫 |
| **按价格筛选** | `search "关键词" --min-price 100 --max-price 500` | — | 价格区间 |

---

## 典型场景

当用户说：
- "淘宝上搜一下咖啡机" / "天猫有什么咖啡机" → `scout taobao search "咖啡机"`
- "只看天猫的" → `scout taobao search "咖啡机" --tmall`
- "100-500 元的" → `scout taobao search "咖啡机" --min-price 100 --max-price 500`
- "按销量排序" → `scout taobao search "咖啡机" --sort sales`
- "看看这个商品" + itemId → `scout taobao detail <itemId>`
- "这个商品评价怎么样" → `scout taobao comments <itemId>`
- "帮我分析这个商品" → `scout taobao insights <itemId>`
- "淘宝上这个品类什么好卖" → 先搜索，再逐个分析 top 商品

---

## URL 解析 - 淘宝/天猫链接处理

用户可能直接贴商品链接，按以下规则提取 itemId：

| URL 特征 | 提取内容 | 调用命令 |
|----------|---------|---------|
| `item.taobao.com/item.htm?id=数字` | itemId (数字) | `scout taobao detail <itemId>` |
| `detail.tmall.com/item.htm?id=数字` | itemId (数字) | `scout taobao detail <itemId>` |
| `m.tb.cn/短链接` | 需要解析 | 提示用户提供商品 ID |

**示例**：
```bash
# 淘宝链接 → 提取 id 参数
# https://item.taobao.com/item.htm?id=713865529993
scout taobao detail 713865529993

# 天猫链接 → 同样提取 id
# https://detail.tmall.com/item.htm?id=668479757611
scout taobao detail 668479757611
```

---

## 核心命令

### 🔍 搜索商品 - `scout taobao search`

按关键词搜索淘宝/天猫商品。

```bash
scout taobao search "咖啡机"
scout taobao search "蓝牙耳机" --sort sales
scout taobao search "瑜伽垫" --tmall --min-price 50 --max-price 200
scout taobao search "手机壳" --page 2
```

**参数**：
- `<keyword>`：搜索关键词（必填）
- `-p, --page`：页码（默认 1，每页 10 条）
- `-s, --sort`：排序 `sales|price_asc|price_desc`（不传为默认综合排序）
- `--tmall`：仅天猫商品
- `--min-price`：最低价（元）
- `--max-price`：最高价（元）
- `-f, --format`：输出格式 `json|text`（默认: json）

**返回数据**：
- `data[]`：商品列表（name、price、originalPrice、sales、shopName、location、sellerRating、itemType）
- `brands[]`：品牌筛选列表（brandName、count）
- `meta`：分页信息

**搜索返回的关键指标**：
- `price` / `originalPrice` — 折后价/原价（元）
- `sales` — 付款人数（如 "1000+"）
- `sellerRating` — 好评率（百分比）
- `itemType` — taobao 或 tmall
- `stock` — 库存数量

### 📦 商品详情 - `scout taobao detail`

获取商品的详细信息。

```bash
scout taobao detail 713865529993
```

**参数**：
- `<itemId>`：商品 ID（必填，纯数字）
- `-f, --format`：输出格式 `json|text`（默认: json）

**返回数据**：`title`、`images`、`url`、`seller`（店铺信息）、`delivery`（发货信息）

### 💬 商品评论 - `scout taobao comments`

获取商品的买家评价。

```bash
scout taobao comments 713865529993
scout taobao comments 713865529993 --page 2
```

**参数**：
- `<itemId>`：商品 ID（必填）
- `-p, --page`：页码（默认 1，每页 20 条）
- `-f, --format`：输出格式 `json|text`（默认: json）

**返回数据**：
- `total` — 评论总数
- `maxPage` — 最大页数
- `comments[]` — 评论列表：`content`（内容）、`score`（评分 1-5）、`date`、`photos`（晒图）、`reply`（卖家回复）、`append`（追评）

**分析重点**：
1. 好评中的高频关键词 = 产品卖点
2. 差评中的问题 = 产品痛点/改进方向
3. 带图评论 = 真实使用场景
4. 追评内容 = 长期使用体验

### 🔬 商品洞察 - `scout taobao insights`

一键获取商品详情 + 评论（组合查询）。

```bash
scout taobao insights 713865529993
```

**参数**：
- `<itemId>`：商品 ID（必填）
- `-f, --format`：输出格式 `json|text`（默认: json）

**返回数据**：`detail`（商品详情）+ `comments`（第一页评论）

---

## 典型工作流

### 淘宝选品调研

```bash
# 1. 搜索目标品类
scout taobao search "便携榨汁机" --sort sales

# 2. 分析 TOP 商品
scout taobao insights <itemId>

# 3. 对比多个商品的评论
scout taobao comments <itemId1>
scout taobao comments <itemId2>

# 4. 跨平台比较
scout search "portable blender" --limit 10     # Amazon 同品类
scout supplier-search "便携式榨汁机"             # 1688 供应商
```

### 竞品分析

```bash
# 1. 搜索竞品关键词
scout taobao search "竞品品牌名" --tmall

# 2. 看竞品 TOP 商品详情
scout taobao detail <竞品itemId>

# 3. 分析竞品评论（找差异化机会）
scout taobao comments <竞品itemId>
```

### 跨平台选品联动

```bash
# 1. Reddit/Twitter 发现趋势
scout reddit trends "产品关键词"
scout twitter trends "产品关键词"

# 2. 淘宝验证国内市场
scout taobao search "产品关键词" --sort sales

# 3. Amazon 验证海外市场
scout search "product keyword" --limit 10

# 4. 找供应商
scout supplier-search "产品中文名"
```

---

## 数据解读参考

### 商品表现判断

| 指标 | 爆款 | 热销 | 一般 |
|------|------|------|------|
| 付款人数 | 10000+ | 1000-10000 | <1000 |
| 好评率 | >98% | 95-98% | <95% |
| 评论数 | >5000 | 1000-5000 | <1000 |

### 价格区间分析

搜索时注意对比：
- `price`（折后价）vs `originalPrice`（原价）→ 折扣力度
- 同品类不同价格带的销量分布 → 主力价格带
- 天猫 vs 淘宝同款价差 → 品牌溢价空间

### 选品信号

| 淘宝信号 | 含义 | 下一步 |
|----------|------|--------|
| 销量高+评论多+好评率高 | 成熟爆款 | 找差异化切入点 |
| 销量增长快+评论少 | 新兴爆款 | 快速跟进窗口 |
| 品类搜索多+好商品少 | 供给不足 | 产品机会 |
| 差评集中某问题 | 痛点明确 | 改进型产品机会 |
| 天猫占比高 | 品牌化品类 | 需要品牌背书 |

---

## 重要提醒

1. **itemId 纯数字**：从商品 URL 中提取 `id=` 后面的数字
2. **每页数量**：搜索 10 条/页，评论 20 条/页
3. **评分映射**：API 返回 1=好评/0=中差评，已映射为 5/1 星
4. **sort 不传为默认排序**：不要传 `default`，直接省略 `--sort` 参数
5. **跨 Skill 联动**：淘宝验证国内市场 → Amazon 验证海外 → 1688 找供应商 → Reddit/Twitter 看社媒趋势
