SuperAPI AI 工具集

ecommerce.walmart-product-analysis

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:查询沃尔玛美国公开商品分析数据,属于公开数据、只读操作,不涉及卖家后台、店铺授权或账户变更。

主要能力:通过 POST /api/v1/tools/research/sorftime/walmart/productAnalysis 接口调用,operation 必填,可选 searchByName、detail、trend 或 salesVolume,并按需提供 name 或 productId;可选 queryDate、queryEndDate、pageIndex。构造请求前需阅读 references/api.md,只发送文档化字段,拒绝未知字段。

使用方式:设置 NEXSCOPE_API_KEY 环境变量,运行 python scripts/sorftime_walmart_product_analysis.py '<JSON参数>' --no-cache,每次调用只处理一个明确请求。最小示例:{"operation":"detail","productId":"5169493923"}。付费失败后未经用户同意不得探测其他商品、市场、页面或操作。

结果处理:外层 code 必须为 0 才能使用数据,非零为平台失败,需展示外层 msg 并报告 traceId;保留完整响应文件,区分传输信封与业务响应,缺失值保留为未知,保留原始货币、单位、标识和日期。

费用与错误:该操作消耗 Nexscope 积分,首次实时响应前具体扣费未知,需保留响应头 X-Cost-Token 与 X-Cost-Credit 作为计费元数据。HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE;HTTP 402 表示积分不足,应停止并引导用户访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。

限制:仅限公开数据只读查询,不得自动替换店铺、地区或创建者;不得在输出中泄露凭证、签名 URL、Cookie 或内部账户标识;未在 references/testing.md 中提供证据时,不得声称已进行实时、ZIP 安装或生产验证。