SuperAPI AI 工具集

ecommerce.shopee-product-detail

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:按一个 Shopee 商品直链获取该 listing 的当前公开详情,涵盖价格、折扣、销量、库存、变体、媒体、品牌等字段。

主要能力:只拉取单个商品;返回价格、货币、库存、公开已售数量、SKU 变体及各变体库存、少量图片、品牌信息,以及 Mall、官方店、认证卖家等标记;评分聚合可能返回,但不返回逐条买家评价。

使用方式:需传入且仅传入一个 productUrl。URL 必须为 HTTPS,且域名属于 shopee.sg、shopee.co.id、shopee.com.my、shopee.ph、shopee.co.th、shopee.tw、shopee.vn、shopee.com.br 之一;路径必须以 -i.<数字shopId>.<数字itemId> 结尾,形如 /product/<shopId>/<itemId> 的规范 URL 不支持。调用端点:POST /api/v1/tools/research/shopee/product/detail;脚本:python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/example-i.9641401.29691169956"}' [--inline] [--no-cache]。需设置 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY;脚本经 Nexscope research proxy 发送请求,超时 150 秒,相同参数缓存 24 小时,完整响应写入 <cwd>/nexscope/<date>/<session>/data/。先读 references/api.md 了解完整参数与响应契约,执行实况请求前读 references/testing.md。

限制:每次仅一个商品,不是关键词搜索或批量筛选工具;返回当前公开快照,非历史数据;字段覆盖因站点与商品状态而异;无效、已删除、不匹配或不支持的 listing 返回错误而非空的成功结果;不管理授权的 Shopee 卖家账号。

错误与计费:HTTP 401 为 Nexscope 认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,勿让用户在聊天或调用 JSON 中粘贴凭证;HTTP 402 为账户积分不足,应停止流程并引导用户前往 access-help 页面;市场授权失败需续期对应平台账号或 token,不得自动改用其他店铺、地区或创建者。响应需外层 code 为 0 才可使用 data,非零为平台失败;HTTP 200 与嵌套业务 code 不能替代该平台校验。需要保留响应头 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据;首次实况响应前确切扣费未知,本操作消耗 Nexscope 积分,不要复用源 Skill 的积分值。展示时以商品名、item ID、店铺、站点、当前价、货币、库存、公开已售数量开头,保留原货币与价格,除非被要求否则不换算;变体与库存可用简表呈现,图片仅少量展示;Mall、官方店、认证卖家标记应分别对待;缺失字段需明确说明。隐私方面需在输出与保存的请求示例中隐去凭证、签名 URL、cookie 及内部账号标识。