SuperAPI AI 工具集

ecommerce.walmart-category-market

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:该技能用于查询沃尔玛美国(Walmart US)类目市场研究数据,属于公开市场数据、只读操作,不涉及卖家后台、店铺授权或账户变更。

主要能力:通过 Nexscope 研究代理调用接口 POST /api/v1/tools/research/sorftime/walmart/categoryMarket,支持三种操作:tree(类目树)、searchByName(按名称搜索)、marketReport(市场报告);部分操作需提供 name 或 nodePath。构造请求前应先阅读 references/api.md,只发送文档中记录的字段,未知字段在联网前即拒绝。最小示例:{"operation":"tree"}。

使用方式:设置环境变量 NEXSCOPE_API_KEY;执行 python scripts/sorftime_walmart_category_market.py '<JSON参数>' --no-cache,每次调用只发一个明确请求。付费失败后未经用户同意不得探测其他产品、市场、页面或操作。需保留完整响应文件,区分 Nexscope 传输信封与内部业务响应,出错时报告 traceId。

结果与计费:仅总结返回的事实,缺失值保留为未知,并标明所请求的市场与操作。该操作消耗 Nexscope 积分,响应头中的 X-Cost-Token 与 X-Cost-Credit 为服务端计费元数据,首次实际响应前具体扣费未知。

错误处理:HTTP 401 表示 Nexscope 认证失败,应检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭据;HTTP 402 表示账户积分不足,应停止流程并引导用户访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。市场授权失败需续期对应平台账户或令牌,不得自动替换店铺、地区或创建者。网络故障需说明是读取还是变更操作,未经对账不得重复变更。

响应校验:研究响应要求外层 code 为数值 0 才可使用数据,非零为平台失败,应展示外层 msg 但不将其措辞理解为重试指令;HTTP 200 与嵌套业务 code/status 不能替代平台校验。解包脚本将平台 code 与 msg 保留在 _nexscope 下,_nexscope.cost 为耗时而非积分。

限制:仅限公开数据只读查询;不得调用卖家控制台、店铺授权、收藏写入或账户变更操作;不得在无证据时声称实时、ZIP 安装或生产验证。完整参数、响应与错误契约见 references/api.md,执行实时请求或声明验证级别前见 references/testing.md。