极鲸云 Temu 店铺搜索分析

解决什么问题

Temu 全托管模式下，卖家需要快速了解竞品店铺的基本情况：在售什么、近期是否活跃、链接指向哪里。难点在于，第三方爬虫拿到的数据往往缺字段、更新滞后，而手动在后台翻页又太慢。本技能直接对接极鲸云 Temu 店铺搜索接口，按用户给定的关键词或榜单条件实时查询，保证拿到的是服务端当前返回的数据，而不是缓存或猜测。

核心能力与执行流程

技能的输入是自然语言查询意图，输出是中文业务结论，所有结论严格限定在店铺层级。

执行时遵循固定路由：

• 先读取 references/Temu店铺搜索.md 获取业务口径和输出规范
• 组装参数时按需读取 references/Temu店铺搜索接口.md
• 涉及热销榜、新店榜时，每次只采用一个最贴合意图的预设，从 references/Temu店铺榜单预设.md 中选取
• 通过 python3 scripts/temu_shop_search.py --param "名称=值" 发起查询，多个条件重复传 --param，多个类目 ID 重复传 catIds

站点处理上，未指定或指定美国站时默认 站点 ID 48；其他国家或地区则先运行 temu_site_list.py --country "国家或地区名"，取唯一精确匹配的结果。类目 ID 只在有可信来源时才传入，不会按类目名称猜测。

登录态由 scripts/geekbi_auth.py 统一读取系统级配置，已有有效凭据时不会重复要求登录。仅在服务端返回 actionRequired 或退出码 2 时，才触发暂停与恢复流程，向用户展示中文提示和跳转链接，待用户完成操作后原样重跑同一命令。

输出与边界

返回后先检查结构、命中总数、当前页、样本量和更新时间。需要全量结果时逐页拉取；如果分页未完成，结论中会明确标注当前仅为样本。

输出时，凡返回非空 linkUrl 的店铺，店铺名称会渲染为可点击链接。错误处理只展示一级中文 msg，不会暴露访问令牌、设备码或原始错误 JSON。

需要强调的适用边界：技能不编造店铺、指标、链接或任何未被服务端返回的经营信息。如果类目 ID 不可省略但用户没有提供明确 ID，查询会停在参数校验阶段，不会擅自猜测。