极鲸云 SHEIN 品类搜索分析
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-qev4qs0i/geekbi-shein-category-search-skill。
技能介绍
要解决的问题
SHEIN 类目运营常见的两类错误:凭类目名称猜 ID,拿到的是过期或错位的标识;对着后台手工翻榜,结论来源无法追溯。结果就是上架、选品、竞品分析建立在不可靠的类目数据上。
这个技能把来源固定在一个: 极鲸云实时接口。只有实时返回的数据才会参与查询与分析,名称相近、路径不明的情况一律不作自主判断。
核心能力
- 可信
catId校验: 不按名称猜测类目 ID。返回结果必须经过完整类目路径、层级和父类目核验后才被采信;路径不唯一或名称相近时,列出候选并交由你确认。 - 站点语义明确: 未指定站点时使用
siteId=1(列表名称“全部”,当前映射 us,并非跨国家聚合);明确美国站使用siteId=2;其他国家或地区先运行python3 scripts/shein_site_list.py --country "..."取得唯一精确匹配的站点 ID。 - 榜单请求支持: 请求热销类目、蓝海类目或机会榜单时,读取对应预设,每次只采用一个最匹配意图的主预设,不混用。
- 登录态复用: 脚本通过
scripts/geekbi_auth.py读取极鲸云 Skills 共用的系统用户配置登录态;已有有效登录态时不重复要求登录,仅在返回actionRequired/ 退出码 2 时展示服务端中文提示与跳转链接,等待你回复继续后原样重跑同一命令。
关键步骤
- 读取参考文档
references/SHEIN类目搜索.md,按业务口径、分析方法和输出要求执行。 - 组装参数时读取
references/SHEIN类目搜索接口.md,只选取本次请求所需的查询参数。 - 从 Skill 根目录运行
python3 scripts/shein_category_search.py --param "名称=值",多个条件重复传入--param。 - 用完整类目路径、层级和父类目核验
catId;名称相近或路径不唯一时列出候选并请用户确认。 - 检查返回结构、命中总数、当前页、样本量和更新时间:
total是精确命中数,但可访问上限为前 10000 条;超出时缩小筛选范围,未完成分页时明确说明结论仅来自样本。需要完整结果时逐页查询。 - 按文档分析数据并输出中文业务结论;对返回非空
linkUrl的类目,把类目名称或完整路径写成可点击链接。
适用边界
- 退出码 1 时只展示错误输出中的一级中文
msg,不展示访问令牌、设备码、请求头、原始错误 JSON 或异常栈。 - 服务端要求用户操作时,才读取并执行
references/查询暂停与恢复流程.md。 - 安装依赖后仍无法运行,应先检查登录态与站点 ID 匹配,而不是反复重试查询。
使用场景
- 运营为美国站确认某个商品应上架到哪个 SHEIN 类目,需要拿到可核验的 catId,不能凭品类名称猜测
- 运营要筛选 SHEIN 蓝海类目,需要先匹配目标国家站点,再按筛选条件查询并查看榜单预设的结论口径
- 数据分析人员需要形成 SHEIN 热销类目榜单,必须按单次意图选用一个主预设,并对命中样本与更新时间做说明
- 商家在处理 SHEIN 类目数据时触发服务端操作要求,需要按服务提示暂停查询,确认完成后再从原命令恢复
适合人员
- 跨境电商运营:为 SHEIN 店铺做上架、类目归属与选品决策,需要可追溯的类目来源
- 品类分析师:输出 SHEIN 类目机会或热销榜结论,需要明确榜单口径、样本量与更新时间
- 工程集成人员:在系统或脚本中调用 SHEIN 类目查询,需要稳定的站点匹配、参数透传与错误退出约定