SuperAPI AI 工具集

linkfox-shopee-product-detail

数据与分析

查看项目

更新于 10-16 00:00

技能介绍

用途:根据一个已知的 Shopee 商品直链,抓取该商品当前的公开详情快照,用于单条商品的价格、销量、库存与内容核对。不是关键词搜索工具,每次调用只处理一个商品。

主要能力:从 URL 推断站点、货币与语言;返回商品标识(itemId、shopId、url、name、brand、categoryId、categoryBreadcrumb)、媒体(image、images、videos)、价格(price、priceBeforeDiscount、priceMin、priceMax、discountPercent、currency)、需求信号(sold、soldDisplayed、rating、ratingCount、ratingDistribution、likedCount)、库存(stock、tierVariations、models)、店铺信息(shopName、shopRating、shopLocation、isMall、官方与认证标识)以及描述、属性等。字段可能缺失或为 null。

使用方式:API 端点 POST /shopee/product/detail;脚本用法 python scripts/shopee_product_detail.py '<JSON 参数>' [--inline]。productUrl 为必填,路径需以 -i.<数字店铺ID>.<数字商品ID> 结尾。支持 shopee.sg、shopee.co.id、shopee.com.my、shopee.ph、shopee.co.th、shopee.tw、shopee.vn、shopee.com.br。结果默认写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件,超过 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印,建议用 jq 按需抽取字段。

限制:不接受 /product/<shopId>/<itemId> 形式的规范链接;不返回顾客评论明细;不提供搜索、历史趋势或卖家账号操作;无效、下架或站点不匹配的链接会报错。各站点字段丰富度不同,越南、巴西、台湾可能返回较简略记录。每次调用消耗 53 算力,重复查询不同商品分别计费。