SuperAPI AI 工具集

ecommerce-ozon-product-detail

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:该技能用于按单个 Ozon(俄罗斯)SKU 拉取完整商品卡数据,数据来源为 MPSTATS。适合已有商品 ID、需要查看价格、销量、库存、评分等指标的场景。

主要能力:返回价格、Ozon Card 价、折扣、评分、评论数、库存、月销量、月销售额、lostProfit、revenuePotential、首次上架日期、图片等。商品卡含 deliveryScheme(FBO 为 Ozon 仓发货,FBS 为卖家发货);传 includeFbs: true 可纳入 FBS 数据,否则以 FBO 为主。含 previousSalesUnits / previousRevenue 上期对比字段,以及 salesPerDayWithStock 等有货天数口径指标。

使用方式:参数 productIds 为数组但必须且只能包含一个 Ozon SKU ID,例如 [1786874757];startDate / endDate 为统计窗口,格式 YYYY-MM-DD,最晚为昨天(T-1);includeFbs 为布尔值。API 端点 /mpstats/ozon/productDetail;脚本命令 python scripts/ozon_product_detail.py '<JSON params>' [--inline]。结果默认写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件,超过 8 KB 时仅打印摘要,可用 --inline 强制完整输出。需配置 NEXSCOPE_API_KEY,遇 401/402 或余额不足需充值。

适用场景:单 SKU 商品卡查询、竞品商品审计、FBO 与 FBO+FBS 指标对比。若需按关键词发现商品,应先用 ecommerce-ozon-product-search;若需单 SKU 逐日时间序列,用 ecommerce-ozon-product-trend;品牌/类目/卖家维度下钻用对应技能。

限制:每次仅一个 SKU,多 ID 会被拒绝;仅覆盖 Ozon,不含 Wildberries;endDate 不能为今天或未来;部分类目 FBS 覆盖不全;不返回 brandId、country、category、minPrice/maxPrice/averagePrice、balanceFbs、frozenStocks、warehousesCount、daysInSite/daysInStock/turnoverDays、position/categoryPosition/revenueSharePercent、isFbs 等字段;标题为俄语,需按需翻译;工具消耗积分,同会话同参数默认 24 小时本地缓存,失败或空结果不应自动换参重试,继续前需告知用户额外积分消耗。