用途:通过 Sorftime 查询 Walmart 美国站商品信息,支持按自然语言名称发现相关商品,或围绕已知 ProductId 查看商品详情、历史趋势和按日销量,常用于竞品发现与跟踪。
主要能力:四种操作,每次请求只能选一种。searchByName 按名称搜索相关商品,每页最多 100 条,pageIndex 默认 1;detail 返回当前商品摘要;trend 返回历史变化;salesVolume 返回按日期的销量行,行格式为 [date, sales, type],type=2 表示昨日销量记录。
使用方式:API 端点为 POST /sorftime/walmart/productAnalysis。也可用脚本:python scripts/sorftime_walmart_product_analysis.py '<JSON 参数>' [--inline]。请求体为扁平 JSON,searchByName 需 name,其余操作需字符串 productId(即使全为数字也按字符串处理)。salesVolume 可选 queryDate、queryEndDate,格式 yyyy-MM-dd;两者都不填返回近 30 天,只填 queryDate 则结束日默认为当天。
输出与成本:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件,禁止写入 /tmp。响应 ≤8 KB 时打印完整 JSON,>8 KB 时只输出摘要,加 --inline 可强制全量打印。相同 JSON 有 24 小时本地缓存。按动态规则计费,单个 Sorftime Request 当前显示为 6 算力,多 Request 由网关整单计算,最终以脚本返回的 costCredit 为准。翻页或追加另一操作都会产生新的付费调用,需先获得用户确认。
限制:仅支持 Walmart 美国站;每次调用只接受一个商品名称或一个商品 ID 及一种操作;历史覆盖范围与数据可用性由 Sorftime 控制,不承诺固定最早日期;searchByName 是自然语言相关商品发现,不是多条件筛选或类目市场查询。未配置 API Key、返回 401/402 或提示算力余额不足时,按引导文档处理。展示结果时应说明所用操作与商品名或 ID,并给出 requestConsumed、costCredit、costToken;缓存命中需说明未产生新计费。