用途:调用 Sorftime 数据研究 Walmart 美国站的类目,支持下载类目层级、用语自然语言类目名匹配相关类目,以及查看某个类目的市场报告与返回的 Best Seller 商品。不涵盖商品数据或关键词数据。
主要能力与操作路由:每次请求只能执行一个操作,不要自动串联;operation 区分大小写。tree 返回完整类目层级,无需其他业务参数,消耗 5 个 Sorftime Request;searchByName 接收自然语言类目名,最多返回三个相关类目匹配,消耗 1 个;marketReport 需要已知的 nodePath,消耗 5 个,禁止凭类目名猜测路径。字段平铺在 JSON 顶层,完整参数与响应见 references/api.md。
使用方式:API 端点为 POST /sorftime/walmart/categoryMarket;Python 脚本为 python scripts/sorftime_walmart_category_market.py '<JSON 参数>' [--inline]。示例:python scripts/sorftime_walmart_category_market.py '{"operation":"tree"}'、'{"operation":"searchByName","name":"patio furniture"}'、'{"operation":"marketReport","nodePath":"4044_623679_1032619_5842891_9823303"}'。响应默认写入工作目录下的 linkfox/<日期>/<session>/data/ 文件,body 超过 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。
成本与限制:同一会话同一参数默认只调用一次,脚本带 24h 本地缓存;失败或空结果不得自动换关键词、翻页或改邮编重试,继续检索需先向用户说明会产生额外消耗并征得同意。三个操作均针对 Walmart 美国站。Sorftime 可能省略不适合第三方卖家的类目,缺失不代表 Walmart 没有该类目。searchByName 不保证精确匹配,tree 响应可能约 10 MB,勿用 --inline 整份输出。遇到未配置 API Key、401/402 或算力不足提示,按 references/onboarding.md 处理。算力按动态规则计费,实际账单以脚本返回的 costCredit 为准。