SuperAPI AI 工具集

ecommerce-walmart-product-analysis

营销与增长

查看项目

更新于 10-16 06:50

技能介绍

用途:通过 Nexscope 研究代理查询 Walmart 美国公开商品分析数据,适用于用户请求该公开市场数据时使用。

主要能力:提供 operation 为 searchByName、detail、trend 或 salesVolume 的查询,必填 name 或 productId,可选 queryDate、queryEndDate、pageIndex(视支持情况)。接口为 POST /api/v1/tools/research/sorftime/walmart/productAnalysis。最小示例:{"operation":"detail","productId":"5169493923"}。

使用方式:先阅读 references/api.md 了解完整参数、响应与错误约定,再校验参数,只发送文档化字段,拒绝未知字段。执行 python scripts/sorftime_walmart_product_analysis.py '<JSON parameters>' --no-cache 一次;付费失败后未经用户批准不得探测其他商品、市场、页面或操作。保留完整响应文件,区分 Nexscope 传输信封与内部业务响应,出错时报告 traceId。

认证与费用:设置 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;HTTP 402 表示积分不足,停止流程并引导用户至帮助页。

限制:仅限公开数据、只读,不得调用卖家控制台、店铺授权、收藏写入或账户变更操作;每次调用一个明确请求,出错后不得静默更改实体、市场、日期、操作或页面;输出需脱敏凭据、签名 URL、Cookie 与内部账户标识;除非 references/testing.md 有对应证据,不得声称实时、ZIP 安装或生产验证。结果呈现以请求实体、市场、操作及决策相关字段为主,保留源货币、单位、标识、日期与缺失值,不虚构换算或默认值。