用途:通过 Nexscope 研究代理查询 Walmart 美国类目市场研究数据,适用于需要该公开市场数据的场景。
主要能力:调用端点 POST /api/v1/tools/research/sorftime/walmart/categoryMarket,支持 operation 为 tree、searchByName 或 marketReport;部分操作需提供 name 或 nodePath。构造请求前应先阅读 references/api.md,只发送文档中记录的字段,未知字段在联网前即拒绝。最小示例:{"operation":"tree"}。
使用方式:先确认请求的公开实体、市场、操作、筛选条件和预期成本,再按 API 参考校验参数。执行 python scripts/sorftime_walmart_category_market.py '<JSON parameters>' --no-cache 一次;付费失败后未经用户批准,不要探测其他产品、市场、页面或操作。保留完整响应文件,区分 Nexscope 传输信封与内部业务响应,出错时报告 traceId。仅总结返回事实,缺失值保留为 unknown。
认证与成本:设置 NEXSCOPE_API_KEY 环境变量;凭据缺失或过期时访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。该操作消耗 Nexscope 积分,首次实时响应前确切费用未知;保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据。HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭据;HTTP 402 表示积分不足,停止流程并引导用户访问上述帮助页。
限制:仅限公开数据、只读操作,不得调用卖家控制台、店铺授权、收藏写入或账户变更操作。每次调用只处理一个明确请求,出错后不得静默更改实体、市场、日期、操作或页面。输出中需脱敏凭据、签名 URL、Cookie 和内部账户标识。除非 references/testing.md 中有对应证据,否则不得声称已实时、ZIP 安装或生产验证。执行实时请求前应阅读 references/testing.md。