用途:针对 Ozon(俄罗斯)单个 SKU 返回每日时间序列,包括销量、价格、库存、评分,可选搜索排名与可见度指标,适合验证某个商品的增长、季节性、异常或断货情况。
主要能力:每次调用只分析一个 productId,返回 data 数组形式的每日数据点,含 hasData 布尔值以区分“无观测”与“销量为零”。可加 includeFbs 纳入 FBS 数据,加 includeSearchStats 附加搜索排名/可见度信号,但小类目可能无覆盖,需说明“该细分无搜索排名数据”。
使用方式:API 端点 /mpstats/ozon/productTrend;脚本 python scripts/ozon_product_trend.py '<JSON params>' [--inline]。参数含 productId(必填,整数)、startDate、endDate(YYYY-MM-DD,最新为昨天)、includeFbs、includeSearchStats。脚本默认将完整响应写入 <cwd>/nexscope/<日期>/<session>/data/ecommerce.ozon-product-trend-<时间戳>.json,≤8KB 打印完整 JSON,>8KB 仅打印摘要,--inline 强制完整输出。数据默认 24 小时本地缓存,同参数组合只调用一次,失败或空结果不要自动换关键词/分页/参数重试,继续前应告知用户会额外消耗 credit。认证或额度问题时设置 NEXSCOPE_API_KEY,余额不足可访问 https://www.nexscope.ai/pricing?co-from=skillNS ,设置指引见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 。
展示规则:建议用表格或迷你趋势图,每行含日期、价格、销量、库存、评分、评论;用 hasData 区分空档与零销量;如实标注单日激增或断货(hasData=true 且 balance=0),不作购买建议;价格货币为 RUB(如 ₽),除非上游已换算;不返回每日营收,用户需要时可用 销量×价格 估算并注明为估算。
限制:每次仅支持一个 SKU,不能传列表;数据 T-1 延迟,结束日期不能是今天或未来;includeSearchStats 不保证所有类目都有覆盖;仅覆盖 Ozon,不含 Wildberries 等其他俄罗斯平台;序列可能存在空档或空值,不得当作零销量;不提供业务建议。