---
name: geekbi-shein-research-skill
description: 通过极鲸云查询和分析 SHEIN 商品、图搜同款、店铺、类目、关键词与评论数据，完成跨境电商选品、市场调研、竞品分析、需求趋势、价格带、竞争强度、用户痛点和机会判断。用户提到 SHEIN 选品、找品、上传图片找同款、拍照搜款、以图搜货、视觉竞品、爆款、新品、蓝海市场、商品表现、全托管、半托管、店铺研究、竞品店铺、类目规模、品类机会、关键词趋势、搜索需求、市场容量、商品评论、差评原因、使用场景、用户反馈或需要组合多类 SHEIN 数据形成经营决策时使用。根据用户意图路由一个或多个内部能力，只依据极鲸云真实返回的数据形成结论。
---

# 极鲸云SHEIN数据分析与市场调研

## 总体原则

- 将本 Skill 作为唯一入口。商品、图搜同款、店铺、类目、关键词和评论搜索是内部能力，不要求用户分别安装或指定技术名称。
- 只使用极鲸云真实返回的数据；明确区分接口事实、可复算指标与分析判断，不编造缺失数据。
- 默认使用简体中文和绝对日期；保留站点、币种、时间范围、筛选条件、分页范围、样本量与数据更新时间。
- 对缺失值、异常值、估算值和未完成分页显式说明。数值为 `0` 时先判断是否可能未统计，不直接解释为真实为零。
- 面向用户只展示中文业务名称，不展示英文参数、请求命令或原始 JSON。只有用户明确要求开发对接、故障排查或原始响应时，才展示必要技术信息。
- 内部完成文档加载、路由、参数生成和脚本调用；进度只描述正在解决的业务问题。
- 图搜同款与商品搜索使用相同的商品字段；`similarNum` 对外统一称为“同款数（跟卖数）”。
- 商品、店铺、关键词与类目对象返回非空 `linkUrl` 时，主要名称必须使用该地址做 Markdown 链接，表格、榜单、候选清单和正文均不得省略。
- 服务端要求暂停查询时，遵循 [查询暂停与恢复流程](references/查询暂停与恢复流程.md)：展示一级 `msg`，有 `jumpUrl` 时展示可点击链接；条件满足后原样重跑请求。

## 能力路由

每次选择一个主能力，只有业务结论确实需要交叉验证时才追加能力。

| 用户意图 | 内部能力 | 必读文档 | 可选预设 |
| --- | --- | --- | --- |
| 找商品、选品、爆款、新品、价格带、销量、同款竞争 | 商品搜索 | [SHEIN商品搜索](references/SHEIN商品搜索.md)、[商品搜索接口](references/SHEIN商品搜索接口.md) | [商品榜单预设](references/SHEIN商品榜单预设.md) |
| 上传图片找同款、拍照搜款、分析图片对应市场 | 图搜同款 | [SHEIN图搜同款](references/SHEIN图搜同款.md)、[图搜同款接口](references/SHEIN图搜同款接口.md)、[商品搜索接口](references/SHEIN商品搜索接口.md) | [商品榜单预设](references/SHEIN商品榜单预设.md) |
| 找店铺、头部店铺、新店、经营效率、托管模式 | 店铺搜索 | [SHEIN店铺搜索](references/SHEIN店铺搜索.md)、[店铺搜索接口](references/SHEIN店铺搜索接口.md) | [店铺榜单预设](references/SHEIN店铺榜单预设.md) |
| 查类目 ID、市场容量、热销或蓝海类目、供需结构 | 类目搜索 | [SHEIN类目搜索](references/SHEIN类目搜索.md)、[类目搜索接口](references/SHEIN类目搜索接口.md) | [类目榜单预设](references/SHEIN类目榜单预设.md) |
| 查词、热销词、蓝海词、新词、需求和竞争 | 关键词搜索 | [SHEIN关键词搜索](references/SHEIN关键词搜索.md)、[关键词搜索接口](references/SHEIN关键词搜索接口.md) | [关键词榜单预设](references/SHEIN关键词榜单预设.md) |
| 评论痛点、使用场景、差评归因、产品改良 | 评论搜索 | [SHEIN评论搜索](references/SHEIN评论搜索.md)、[评论搜索接口](references/SHEIN评论搜索接口.md) | 无 |

只在用户表达榜单意图时读取预设；普通搜索不叠加榜单条件。

## 执行流程

1. 明确决策问题、目标站点、市场边界、时间口径和硬性条件；不影响结论时采用合理默认并说明。
2. 按能力路由只读取本次任务需要的文档。
3. 未指定站点时使用 `siteId=1`（站点列表名称“全部”，当前映射 `us`，不是跨国家聚合）；明确美国时使用 `siteId=2`。其他国家或地区运行 `scripts/shein_site_list.py` 实时解析；无唯一匹配时请用户确认，不猜测。评论同样遵守此规则。
4. 从全新参数对象生成最小请求，不继承上一轮或网页残留条件。商品运行 `scripts/shein_goods_search.py`，图搜运行 `scripts/shein_image_search.py`，店铺运行 `scripts/shein_shop_search.py`，类目运行 `scripts/shein_category_search.py`，关键词运行 `scripts/shein_keyword_search.py`，评论运行 `scripts/shein_review_search.py`。
5. 公共请求封装统一处理登录和查询暂停；恢复后原样重跑业务请求。
6. 检查响应、分页、缺失字段、异常值、时间口径与可比性。商品、店铺、类目、关键词只允许分页访问前 10000 条；`total` 是精确命中数，但超过 10000 时必须缩小筛选范围，不能声称已取得完整分布。未完成全量分页时标为样本。图搜要求全部结果或完整市场分析时，以同图、同筛选每页 200 条翻页，直至覆盖服务端本次视觉候选池与筛选条件的全部交集；候选池上限 1000，命中总数等于 1000 时不得称全平台全部同款。
7. 主查询完成后决定是否交叉验证。简单搜索直接回答，不强制扩展成完整报告。
8. 输出结论、数据口径、证据、机会与风险和下一步动作；发送前检查所有非空 `linkUrl` 是否已绑定对象名称。

## 组合调研链路

按问题裁剪，不机械执行全部步骤：

```text
类目：确定边界、规模和供需
  → 关键词：验证需求、增长与搜索竞争
  → 商品：核验价格、销量、同款竞争与上架时间
  → 评论：核验卖点、痛点、规格风险与改良方向
  → 店铺：核验集中度、经营模式与头部卖家表现
```

- 用户提供图片时先图搜形成视觉候选池，再用商品指标筛选；不得先主观转写成关键词替代图搜。
- 用户只查单一对象时只调用对应主能力。
- 完整选品优先按“类目 → 关键词 → 商品 → 评论 → 店铺”逐步缩小；已有明确关键词、商品或店铺时可从对应环节开始。
- 只有取得明确商品 ID 且评论能影响决策时才增加评论搜索。
- 多能力对比必须统一站点、币种、时间窗和筛选边界；口径不同则停止直接排名。

## 共享业务口径

- `siteId` 是极鲸云站点 ID，`siteUID` 是 SHEIN 数据分区标识，两者不能混用。`siteId=1` 名称虽为“全部”，当前与美国站 `2` 都映射 `us`，不得描述为跨站聚合；跨站研究必须逐站查询并统一币种和时间口径。
- 商品、店铺、类目、关键词共用类目 ID。优先使用类目搜索所得的一、二级类目，不按名称猜 ID。
- 商品 `sold/sales` 表示最近销量/销售额，未确认固定窗口时不硬写成 90 天；店铺 `mallSold/mallSales`、关键词与类目 `sold/sales` 表示近 3 个月销量/销售额；各能力的 `totalSold/totalSales` 表示累计总量。
- 日、周、月变化率是小数比例：`0.25` 表示增长 25%，`-0.1` 表示下降 10%。店铺、类目、关键词的周期销量、销售额、商品数、店铺数与粉丝数是日/周/月均值，对应 Rate 才是变化率；当前总量使用 `goodsNum`、`followerNum`、`itemCount`、`mallCount`。商品自身的日/周/月销量和销售额不是这组均值口径。
- 商品价格、平均价格和销售额使用站点本地币种；供货价使用人民币。跨站点或利润计算前统一币种，并说明汇率与时间。
- 托管模式只使用 `1=全托管`、`2=半托管`；不传表示不限。
- `dsr` 是极鲸云预计算蓝海指数，越高通常越偏蓝海；未知计算公式，不自行解释为具体除法。
- 同款数（跟卖数）越高表示同行销售相同商品越多、核价通过概率通常越低。一般不超过 10 较优，11–20 表示竞争增加，超过 20 时除非有工厂或供应链优势，否则需谨慎。

## 输出要求

### 名称链接硬性规则

1. 先提取主要名称与服务端原样返回的 `linkUrl`，再组织表格或分析。
2. 商品、店铺、关键词、类目的每次展示都使用 `[名称](<linkUrl>)`；不得单设裸链接列，不用“查看详情”替代名称，不自行拼接链接。
3. 发送前逐个结果块核对：非空 `linkUrl` 对象数必须等于可点击名称数。
4. 用户只索要链接时，直接返回可点击名称，不附接口说明。

默认顺序：一句话结论；数据口径；关键发现；机会与风险；按优先级给出验证动作。用户只要列表时保持简洁。