SuperAPI AI 工具集

ecommerce-ozon-product-trend

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:针对单个 Ozon(俄罗斯)SKU 返回每日时间序列,包含每日销量、价格、库存、评分,可选搜索排名/可见度指标,适合验证某商品的增长、季节性、价格走势或异常。

主要能力:单 SKU 范围,每次调用只分析一个 productId;按天粒度返回 [startDate, endDate] 窗口内的每日数据点(顶层字段 data),每个点带 hasData 布尔值,hasData=false 表示当天无观测,区别于销量为 0;数据延迟一天(T-1),可选 endDate 最晚为昨天,今天或未来日期会被拒绝;设置 includeSearchStats: true 可附加搜索排名/可见度信号,但部分小众类目可能无覆盖,字段可能为空。

使用方式:API 端点 /mpstats/ozon/productTrend;Python 脚本 python scripts/ozon_product_trend.py '<JSON params>' [--inline]。参数:productId(整数,必填)、startDate、endDate(YYYY-MM-DD,最晚昨天)、includeFbs(是否包含 FBS 数据)、includeSearchStats。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ecommerce-ozon-product-trend-<timestamp>.json;响应体不超过 8 KB 时打印完整 JSON,超过则只打印摘要;加 --inline 强制完整输出到 stdout。需设置 NEXSCOPE_API_KEY 环境变量,遇到 401/402 或余额不足需充值。

适用场景:单 SKU 时间序列分析,如某 Ozon SKU 上月销售趋势、是否季节性、近期是否缺货、Q1 价格走势、搜索排名是否改善。

限制:每次仅一个 SKU,不能传 productId 列表;数据 T-1,endDate 不能是今天或未来;搜索统计不保证所有类目覆盖;仅支持 Ozon,不含 Wildberries 等其他俄罗斯平台;序列可能有缺失/空值,不应视为零销量;不返回每日收入,如需可按销量×价格估算并注明为估算;不提供购买建议。