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