用途:根据一个公开的 Shopee 商品链接,获取该商品当前的公开详情,包括价格、折扣、销量、库存、变体、媒体、品牌等字段。仅支持单个商品,不是关键词搜索或批量筛选工具,返回的是当前快照而非历史数据。
支持范围:仅接受 HTTPS URL,主机须为 shopee.sg、shopee.co.id、shopee.com.my、shopee.ph、shopee.co.th、shopee.tw、shopee.vn、shopee.com.br 之一;URL 路径须以 -i.<数字 shopId>.<数字 itemId> 结尾,标准的 /product/<shopId>/<itemId> 形式不支持。
调用方式:端点 POST /api/v1/tools/research/shopee/product/detail;脚本用法为 python scripts/shopee_product_detail.py '<JSON params>' [--inline] [--no-cache],参数中必须且只传一个 productUrl。示例:python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/example-i.9641401.29691169956"}'。使用前需设置 NEXSCOPE_PROXY_BASE 和 NEXSCOPE_API_KEY。脚本经 Nexscope 研究代理发送请求,超时 150 秒,相同参数缓存 24 小时,完整响应始终写入 <cwd>/nexscope/<date>/<session>/data/。
结果与限制:展示时先给出商品名、item ID、店铺、市场、当前价格、币种、库存与公开销量;保留原始币种与价格,除非用户要求否则不做换算;有 SKU 与分变体库存时用紧凑表格;图片只展示少量有用样本;Mall、官方店、认证卖家标记视为独立信号;描述、变体、库存、销量等字段缺失时明确说明。该工具不返回客户评价明细,可能提供评分聚合;字段覆盖因市场与商品状态而异;无效、已删除、不匹配或不支持的商品返回错误而非空成功结果;不管理已授权的 Shopee 卖家账户。
认证与错误:HTTP 401 表示 Nexscope 认证失败,应检查环境变量,不要让用户在聊天或操作 JSON 中粘贴凭证;HTTP 402 表示账户积分不足,应停止流程并引导用户到访问帮助页;市场授权失败需按平台续期账户或令牌,不要自动替换店铺、地区或创建者;网络失败原因不明时需说明是读取还是变更操作,变更操作未核对上游状态前不得重试。该操作消耗 Nexscope 积分,需保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据;首次实盘响应前具体费用未知。使用时须从面向用户输出与保存的请求示例中隐去凭证、签名 URL、Cookie 与内部账户标识。