用途:按单个 Ozon(俄罗斯站)SKU 查询 MPSTATS 全量商品卡,用于竞品商品审计、FBO/FBS 履约模式指标对比及单 SKU 销售、价格、库存、评分数据核对。
主要能力:返回价格、Ozon Card 价、折扣、评分、评论数、库存、月销量、月销售额、潜在销售额(revenuePotential)、损失销售额与损失占比、上架日期、图片等字段;含 deliveryScheme(FBO/FBS)、上一周期 previousSalesUnits / previousRevenue、有库存天数口径的 salesPerDayWithStock 等指标。
使用方式:API 端点 POST /mpstats/ozon/productDetail;脚本命令 python scripts/mpstats_ozon_product_detail.py '<JSON 参数>' [--inline]。关键参数为 productId(必填,单个 SKU),可选 startDate、endDate(YYYY-MM-DD,最晚为昨日)与 includeFbs(true 表示纳入 FBS 数据,默认 FBO 为主)。示例:{"productId": 1786874757, "startDate": "2025-03-01", "endDate": "2025-03-31", "includeFbs": true}。响应默认落盘到 <cwd>/linkfox/<日期>/<session>/data/ 下;大于 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印。
适用场景:已知单个 SKU 时拉取商品卡;配合 mpstats-ozon-product-search 先由关键词/品牌/卖家解析出 productId 再查详情;单 SKU 逐日趋势应改用 mpstats-ozon-product-trend;品牌/类目/卖家维度应改用对应下钻技能。
限制:仅接受单个 productId,数组或列表无效,多 SKU 需逐个调用并先确认额外算力消耗;仅覆盖 Ozon,不含 Wildberries;数据截至 T-1,传入今天或未来日期会被拒绝;部分类目 FBS 覆盖不全;不返回 brandId、国家、类目、minPrice/maxPrice/averagePrice、balanceFbs、冻结库存、仓库数、在架/在库天数、周转天数、排名、isFbs 等字段;商品标题为俄文原文,需按需翻译。认证缺失或返回 401/402、提示余额不足时按 onboarding 文档处理。按动态规则计费,消耗算力 = 12(productId 为空返回 0),可能一次性消耗大量算力,须先提醒用户并由用户决定是否继续。