用途:该技能用于查询 Walmart 美国站的关键词研究数据,属于公开市场数据、只读操作。使用前需先阅读 references/api.md 了解完整参数、响应与错误约定。
主要能力:接口为 POST /api/v1/tools/research/sorftime/walmart/keywordResearch。必填 operation,可选值为 marketQuery、searchByName、searchProducts、detail、productKeywords、relatedKeywords 或只读 favoriteList,并需提供对应操作的标识符;可选字段为所选操作已文档化的筛选与分页参数。只发送文档化字段,未知字段在联网前拒绝。最小示例:{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}。
使用方式:先确认请求的公开实体、市场、操作、筛选与预期成本,再对照 API 参考校验参数,然后运行 python scripts/sorftime_walmart_keyword_research.py '<JSON参数>' --no-cache 一次。付费失败后未经用户批准,不得探测其他商品、市场、页面或操作。保留完整响应文件,区分 Nexscope 传输信封与内部业务响应,出错时报告 traceId。
认证与计费:需设置 NEXSCOPE_API_KEY 环境变量。该操作消耗 Nexscope 积分,首次实时响应前具体费用未知;保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据。HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭据;HTTP 402 表示积分不足,停止流程并引导用户访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。
结果呈现:先给出请求实体、市场、操作及最具决策价值的返回字段;保留原始货币、单位、标识符、日期与缺失值,不虚构换算或默认值;保留完整 JSON 产物,重复记录可用紧凑表格展示;报告 X-Cost-Token、计算出的 Nexscope 积分与 trace ID。
限制与隐私:仅限公开数据只读,不得调用卖家后台、店铺授权、收藏写入或账户变更操作;每次调用一个明确请求,出错后不得静默更改实体、市场、日期、操作或页面;输出与保存的请求示例中需脱敏凭据、签名 URL、Cookie 与内部账户标识;除非 references/testing.md 中有对应证据,不得声称已实时、ZIP 安装或生产验证。