用途 该技能用于查询沃尔玛美国（Walmart US）市场的关键词研究数据，通过 Nexscope 研究代理访问公开市场数据。资料载明其定位为公开数据、只读迁移，不用于卖家控制台、店铺授权、收藏写入或账户变更类操作。
主要能力 请求接口为 POST /api/v1/tools/research/sorftime/walmart/keywordResearch。支持的操作类型包括：marketQuery（市场查询）、searchByName（按名称搜索）、searchProducts（按产品搜索）、detail（详情）、productKeywords（产品关键词）、relatedKeywords（相关关键词）以及只读的 favoriteList（收藏列表）。每种操作需要提供对应的标识符。可选参数为所选操作对应的文档化过滤条件与分页参数。资料强调只发送文档中列出的字段，未知字段应在发起网络请求前拒绝。
使用方式 使用前需阅读 references/api.md 以了解完整参数、响应与错误约定，并阅读 references/testing.md 再执行实际请求或声明验证级别。需设置环境变量 NEXSCOPE_API_KEY；如凭证缺失或过期，可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值积分。调用方式为运行 python scripts/sorftime_walmart_keyword_research.py '<JSON 参数>' --no-cache 一次。示例请求：{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}。资料要求每次调用只对应一个明确请求，出错后不得静默更改实体、市场、日期、操作或页码；付费失败后未经用户批准不得尝试其他产品、市场、页面或操作。
响应与错误处理 研究响应需外层数值 code 等于 0 才可使用数据；非零 code 视为平台失败，应显示外层 msg，但不将其措辞理解为重试指令。仅 HTTP 200 或嵌套业务 code/status 不能替代平台检查。HTTP 401 表示 Nexscope 认证失败，应核对 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE，且不应要求用户将凭证粘贴到聊天或操作 JSON 中。HTTP 402 表示账户积分不足，应停止工作流并按帮助页面处理。市场授权失败需更新平台特定账户或令牌，不得自动替换其他店铺、区域或创建者。网络失败含义不明时，应报告该操作是读取还是变更，且不得在未对账上游状态的情况下重复变更操作。
计费 该操作消耗 Nexscope 积分，资料明确不应复用源技能的积分值。首次实际响应前确切费用未知。应将响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务器报告的计费元数据保留；_nexscope.cost 表示耗时而非积分。
结果呈现与限制 呈现结果时应先给出请求的实体、市场、操作及最具决策相关性的返回字段，保留来源货币、单位、标识符、日期与缺失值，不虚构换算或默认值；保留完整 JSON 结果，重复记录可用紧凑表格展示，并报告 X-Cost-Token、计算出的 Nexscope 积分及 trace ID。对用户输出与保存的请求示例中应屏蔽凭证、签名 URL、Cookie 和内部账户标识符。资料明确不得在缺少 references/testing.md 相应证据时声称已完成实时、ZIP 安装或生产验证。