linkfox-geekbi-temu-product
使用 GeekBI 研究 Temu 公开市场商品,支持商品筛选、goodsId 详情、最近 30 天历史、供货价、库存及日/周/月销量、销售额和增长分析。适用于用户明确指定 GeekBI 或需要这些差异指标的研究;通用关键词、品类、价格、评分或销量筛选使用对应 Temu 商品查询技能,单独枚举站点或品类不自动触发,也不适用于卖家账号、订单、刊登或广告操作。
SKILL.mdskills/linkfox-geekbi-temu-product/SKILL.md
GitHubGeekBI Temu 商品搜索与详情
适用范围
适用
使用 GeekBI 查询 Temu 公开市场商品及近期趋势。用户明确指定 GeekBI、本技能,或需要供货价、库存、日/周/月指标及增长等差异字段时使用。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 用 GeekBI 查 Temu 商品 | 按目标市场与条件检索商品。 |
| 看这个 goodsId 的详情和近 30 天趋势 | 查询当前商品资料及每日历史。 |
| 查 Temu 商品供货价和库存 | 展示可用供货价和库存指标。 |
| 比较日、周、月销量或销售额增长 | 比较各统计口径及增长字段。 |
边界
仅按关键词、品类、价格、评分、销量或销售额进行通用筛选时,使用 linkfox-temu-product-query。除非用户明确要求跨数据源对比,不同时调用两条付费商品数据技能。
站点与品类是商品研究的辅助能力;仅枚举站点或品类不自动触发本技能。用户明确调用本技能或本技能已激活时,可独立查询站点或品类辅助数据。
不处理 Temu 卖家账号授权、订单、库存更新、刊登发布、履约、广告或其他平台研究。
接口清单
| 接口 | 端点 | 对应脚本 | 说明 |
|---|---|---|---|
| 商品搜索(goodsSearch) | POST /geekbi/temu/goodsSearch |
scripts/geekbi_temu_goods_search.py |
按市场和筛选条件返回分页商品。 |
| 商品详情(goodsDetail) | POST /geekbi/temu/goodsDetail |
scripts/geekbi_temu_goods_detail.py |
查询单个商品及最近 30 天历史。 |
| 站点列表(siteList) | POST /geekbi/temu/siteList |
scripts/geekbi_temu_site_list.py |
确定商品研究的目标市场。 |
| 品类列表(categoryList) | POST /geekbi/temu/categoryList |
scripts/geekbi_temu_category_list.py |
查询一级品类或逐级下钻。 |
前置条件
确认用户指定的数据源、市场与研究目标,只准备任务需要的信息。参数来源、默认值、限制和响应字段见 references/api.md。
商品研究流程
- 先确认用户要搜索、单品深查还是辅助查询;只执行任务需要的步骤。已有有效市场或品类编号时,直接复用,避免额外查询。
- 市场未知时查询站点列表;需要品类筛选且编号未知时查询品类列表,必要时逐级下钻。编号复用规则见
references/api.md。 - 按已确定的市场和筛选条件搜索商品;用户已提供明确商品编号时,可直接进入详情查询。搜索无有效编号时停止链式查询并说明原因。
- 仅在用户需要时,以搜索得到的商品编号及同一市场查询详情。用户只给商品链接时,仅在编号无歧义时提取;否则请用户补充,不能从标题猜测。
- 先展示本次取得的数据。只查辅助数据时,不附带付费搜索或详情;失败、空结果或瞬时错误时停止链式研究,按接口文档处理。付费重试与站点、品类辅助接口的有限重试分别遵守
references/api.md。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:商品搜索、商品详情各消耗 15 算力 / 次;站点列表、品类列表不消耗算力 (限时)。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改站点连续试探;需要继续付费检索时,先向用户说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-geekbi-temu-product-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错,不回退到用户目录或系统临时目录。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、状态与计数字段(如
errcode、errmsg、total)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
商品搜索、商品详情各消耗 15 算力 / 次;站点列表、品类列表不消耗算力 (限时)。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 控制付费研究范围:每次付费调用都可能产生新费用。同一会话、同一端点和参数默认只调用一次;高频调用、翻页或从搜索继续查询多个商品详情前,说明额外消耗并由用户决定是否继续。缓存与刷新约定见
references/api.md。 - 区分市场与内部标识:
regionId表示市场,siteId是上游内部标识;商品与品类编号保留供后续使用。具体取值和复用要求见接口文档。 - 清晰展示数据:注明市场、可用站点名称与币种、筛选条件及本次分页范围;表格展示返回的标题、商品编号、价格区间、累计/月销量、销售额、评分、评论、库存、店铺、品类、状态及上架时间。
- 分开展示当前资料与历史:详情先展示当前商品,再展示最近 30 天内可用历史,标明每行使用的日期字段;返回历史不保证每天都有记录。
- 保留原始口径:仅对接口明确为增长率的字段标注百分比,不擅自换算单位;货币口径见接口文档。缺失和
null显示为不可用,不补零,不臆造字段;保留extraFields扩展。 - 按需读取数据:大响应摘要忽略
columns渲染元数据,并保持各接口业务列表的独立识别;完整数据始终落盘,按需抽取字段。
使用示例
按市场筛选商品,再查询指定商品
用户:用 GeekBI 找美国市场的连衣裙,并查看选定商品的库存和近 30 天变化。
确认筛选目标后查询商品列表,展示候选及统计口径;用户指定商品后,复用商品编号和市场查询详情。多个商品深查前先说明新增消耗。
已有商品编号时直接深查
用户:用 GeekBI 看这个 goodsId 的详情和最近趋势。
确认目标市场后直接查询详情,分开呈现当前商品资料和可用历史记录。
独立查询辅助数据
用户:使用本技能查看 Temu 站点,或查看某个品类的下一级。
只执行所需站点或品类辅助查询,展示可用市场或品类编号,不附带付费商品研究。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。