SuperAPI AI 工具集

ecommerce-ozon-product-report-search

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:查询 Seerfar Ozon 商品数据库,按多项业绩指标筛选并返回商品级报告,用于 Ozon 选品、竞品商品分析、爆款挖掘与价格/转化筛选。数据单位为商品(每个 SKU 一行),而非关键词。

主要能力:支持按分页与排序、SKU、关键词、类目 ID、卖家、品牌(含/排除/无品牌)、履约方式(OZON/FBO/FBS/RFBS/FBP)、标签(新品/正品/畅销)、上架时长(1/3/6/12/24 个月)、变体合并、数据月份(searchDate)以及各类数值区间筛选:月销量及其增速、月销售额、价格(₽)、加购转化率、评分、评论数、问答数、变体数、广告成本占比、毛利率、退货取消率、重量、体积。响应中 data 与 products 为相同数组,total 为匹配总数。六个字段存在统一键与原始键重复(sku/productId、sales/monthlySalesUnits、revenue/monthlySalesRevenue、reviewRating/rating、brandName/brand、productUrl/productPageUrl),取值相同。

使用方式:调用 API 端点 /seerfar/ozon/productReportSearch,或运行 Python 脚本 scripts/ozon_product_report_search.py '<JSON params>' [--inline]。page 为必填,其余参数可选;区间过滤传 {min,max} 对象。结果默认写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件,超过 8 KB 时标准输出仅打印摘要,可用 --inline 强制完整输出,再用 jq 提取所需字段。需配置 NEXSCOPE_API_KEY;401/402 表示未配置密钥或积分不足。示例:{"page":{"page":1,"pageSize":10,"orders":[{"field":"sales","direction":"DESC"}]}}。

适用场景:Ozon 按销量/销售额选品、爆款与新品挖掘、高转化低退货筛选、品牌/卖家表现分析、指定 SKU 查询。

限制:仅 Ozon(sourceType 固定为 ozon);单次请求 SKU 上限 10;categoryIds 需使用 Seerfar 类目 ID;total 可为数千万,须排序分页;触发限流错误码 1003 时应稍后重试;同会话同参数组合默认只调用一次并启用 24 小时本地缓存,失败或空结果不自动换参重试,继续检索前需先告知用户将额外消耗积分。价格与销售额均为俄罗斯卢布(₽)。