linkfox-mpstats-ozon-product-trend

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MPSTATS Ozon Product Trend (Daily Time-Series)

MPSTATS Ozon 商品趋势（分日时间序列）

This skill returns a daily time-series of a single Ozon (Russia) SKU — sales units, price, stock, rating, and optionally search-position / visibility metrics. It is the go-to for validating growth, seasonality, or anomalies for a specific product.

该技能返回Ozon（俄罗斯站点）单个SKU的分日时间序列数据，包括销量、价格、库存、评分，还可选择附带搜索位次/可见性指标。它是验证特定商品增长趋势、季节性特征或异常波动的首选工具。

Core Concepts

核心概念

Single-SKU scope: Each call analyzes exactly one

productId

. For batch per-SKU snapshots (period aggregates), use

mpstats-ozon-product-detail

instead.

Daily granularity: The response is an array of daily points (top-level field

data

) across the

[startDate, endDate]

window. Each point carries a

hasData

boolean — if

hasData=false

, the day has no observation (distinct from

sales=0

with

hasData=true

T-1 delay: MPSTATS trend data is delayed by one day; the latest selectable end date is yesterday. Today or future dates are rejected.

Search-visibility add-on: Set

includeSearchStats: true

to append search-position / visibility signals. Some niches (especially small categories) may not have search-stats coverage — expect partial or empty fields in those cases.

单SKU范围：每次调用仅分析一个

productId

。如需批量获取SKU快照（周期聚合数据），请使用

mpstats-ozon-product-detail

技能。

日粒度：响应结果为

[startDate, endDate]

时间范围内的每日数据点数组（顶级字段为

data

）。每个数据点包含一个

hasData

布尔值——若

hasData=false

，表示该日无观测数据（与

hasData=true

且

sales=0

的情况不同）。

T-1延迟：MPSTATS趋势数据延迟1天；可选择的最晚结束日期为昨天。今日或未来日期将被拒绝。

搜索可见性附加项：设置

includeSearchStats: true

可追加搜索位次/可见性数据。部分细分品类（尤其是小品类）可能无搜索数据覆盖，此类情况下会出现字段部分为空或完全为空的情况。

Parameters

参数

Parameter	Type	Required	Description
productId	integer	yes	Ozon SKU (numeric)
startDate	string	no	Window start, `YYYY-MM-DD` ; latest = yesterday
endDate	string	no	Window end, `YYYY-MM-DD` ; latest = yesterday
includeFbs	boolean	no	Include FBS data alongside FBO
includeSearchStats	boolean	no	Attach search position / visibility signals

参数	类型	是否必填	描述
productId	整数	是	Ozon SKU（数字格式）
startDate	字符串	否	时间范围起始日期，格式为 `YYYY-MM-DD` ；最晚可设为昨天
endDate	字符串	否	时间范围结束日期，格式为 `YYYY-MM-DD` ；最晚可设为昨天
includeFbs	布尔值	否	同时包含FBS与FBO数据
includeSearchStats	布尔值	否	附加搜索位次/可见性数据

API Usage

API 使用说明

This tool calls the LinkFox tool gateway API. See

references/api.md

for calling conventions, request parameters, response structure, and error codes. You can also execute

scripts/mpstats_ozon_product_trend.py

directly for ad-hoc queries.

该工具调用LinkFox工具网关API。调用规范、请求参数、响应结构及错误码请参阅

references/api.md

。您也可直接执行

scripts/mpstats_ozon_product_trend.py

进行临时查询。

Usage Examples

使用示例

1. Monthly trend for a SKU

json

{
  "productId": 1786874757,
  "startDate": "2025-03-01",
  "endDate": "2025-03-31"
}

2. Trend with search visibility

json

{
  "productId": 1786874757,
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "includeSearchStats": true
}

3. Combined FBO+FBS trend

json

{
  "productId": 151623766,
  "startDate": "2025-01-01",
  "endDate": "2025-01-31",
  "includeFbs": true
}

1. 某SKU的月度趋势

json

{
  "productId": 1786874757,
  "startDate": "2025-03-01",
  "endDate": "2025-03-31"
}

2. 包含搜索可见性的趋势

json

{
  "productId": 1786874757,
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "includeSearchStats": true
}

3. FBO+FBS合并趋势

json

{
  "productId": 151623766,
  "startDate": "2025-01-01",
  "endDate": "2025-01-31",
  "includeFbs": true
}

How to Chain with Other Ozon Skills

与其他Ozon技能的联动方式

Discovery → trend: Use
```
mpstats-ozon-product-search
```
to find a SKU, then check growth / volatility here before committing.
Aggregate vs time-series:
```
mpstats-ozon-product-detail
```
gives a one-number-per-metric period view; this skill shows the day-by-day shape behind those numbers.
Drill-down → trend: After
```
brand-products
```
/
```
category-products
```
/
```
seller-products
```
surfaces a hot SKU, use this skill to validate whether the hotness is recent, seasonal, or sustained.

发现→趋势：使用
```
mpstats-ozon-product-search
```
找到目标SKU，再通过本技能查看其增长/波动情况，之后再做决策。
聚合数据vs时间序列：
```
mpstats-ozon-product-detail
```
提供周期内各指标的单一汇总值；本技能则展示这些数值背后的每日变化趋势。
深入分析→趋势：通过
```
brand-products
```
/
```
category-products
```
/
```
seller-products
```
技能发现热门SKU后，使用本技能验证该热度是近期突发、季节性还是持续性的。

Display Rules

展示规则

Prefer a simple table or sparkline-friendly output — one row per date with
```
date
```
,
```
price
```
,
```
sales
```
,
```
balance
```
,
```
rating
```
,
```
comments
```
; do not overfit a 90-point series into a single paragraph.
Use
hasData
to distinguish gaps from zero sales —
```
hasData=false
```
means the day has no observation; don't report it as a zero-sale day.
Call out anomalies — large single-day spikes or stockouts (
```
balance=0
```
runs where
```
hasData=true
```
) should be flagged factually, not as buying advice.
Currency is RUB unless upstream layer is already converting (the
```
currency
```
field per point carries the symbol, e.g.
```
₽
```
); state the currency when showing price movement.
Revenue is not returned per day — if the user asks for daily revenue, estimate via
```
sales * price
```
and note it's an estimate.
includeSearchStats
gaps — when no search-visibility fields come back, note "搜索位次数据在该赛道暂不可用" rather than silently omitting.
No business advice — present the shape; leave "should we buy this listing?" to the user.

优先采用简洁表格或适合迷你图的输出格式——每行对应一个日期，包含
```
date
```
、
```
price
```
、
```
sales
```
、
```
balance
```
、
```
rating
```
、
```
comments
```
字段；请勿将90个数据点的序列强行塞进单个段落。
利用
hasData
区分数据缺失与零销量——
```
hasData=false
```
表示该日无观测数据，请勿将其报告为零销量日。
标注异常情况——单日销量大幅飙升或缺货（
```
hasData=true
```
且
```
balance=0
```
的连续时段）应如实标注，而非作为购买建议。
默认货币为卢布（RUB），除非上游层已进行货币转换（每个数据点的
```
currency
```
字段包含货币符号，如
```
₽
```
）；展示价格变动时需说明货币类型。
不返回每日营收数据——若用户询问每日营收，可通过
```
sales * price
```
估算，并注明该数值为估算值。
includeSearchStats
数据缺失——当未返回搜索可见性字段时，需注明“搜索位次数据在该赛道暂不可用”，而非静默省略。
不提供商业建议——仅展示数据趋势，是否购买该商品的决策交由用户自行判断。

Important Limitations

重要限制

Single SKU per call — cannot pass a list of
```
productId
```
s; loop at the Agent layer if needed.
T-1 data —
```
endDate
```
cannot be today or a future date.
Search stats optional —
```
includeSearchStats=true
```
doesn't guarantee coverage for all niches.
Ozon-only — Wildberries and other Russian marketplaces are not covered.
Missing days — the series may have nulls / gaps where no data was captured; do not treat nulls as zero sales.

每次调用仅支持单个SKU——无法传入
```
productId
```
列表；如需批量处理，需在Agent层循环调用。
T-1延迟数据——
```
endDate
```
不能设为今日或未来日期。
搜索数据为可选项——设置
```
includeSearchStats=true
```
不保证所有细分品类都有数据覆盖。
仅支持Ozon平台——不支持Wildberries及其他俄罗斯电商平台。
存在数据缺失日期——序列中可能存在未捕获数据的空值/缺口；请勿将空值视为零销量。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — Single-SKU temporal analysis:

User Says	Scenario
"What's the sales trend of Ozon SKU 1786874757 last month"	Monthly time-series
"Is this Ozon listing seasonal or stable"	Seasonality check
"Did this Ozon product have stockouts recently"	Stock anomaly detection
"Price walk for this Ozon product over Q1"	Price movement
"Did this listing's search position improve"	Search visibility (requires `includeSearchStats` )

Not applicable — Needs beyond single-SKU time-series:

Batch snapshot of many SKUs →
```
mpstats-ozon-product-detail
```
Brand / category / seller drill-down → matching
```
*-products
```
skill
Pre-IDed discovery →
```
mpstats-ozon-product-search
```

Boundary judgment: Use this skill when the question starts with "how did this ONE product change over time". For multi-SKU comparisons or dimension-level filtering, go elsewhere.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

适用场景——单SKU时间维度分析：

用户表述	场景
"Ozon SKU 1786874757上个月的销量趋势如何"	月度时间序列分析
"这款Ozon商品是季节性的还是稳定的"	季节性特征验证
"这款Ozon商品最近是否出现缺货情况"	库存异常检测
"这款Ozon商品第一季度的价格走势如何"	价格变动分析
"这款商品的搜索位次是否有所提升"	搜索可见性分析（需设置 `includeSearchStats` ）

不适用场景——超出单SKU时间序列分析的需求：

批量获取多个SKU快照 → 使用
```
mpstats-ozon-product-detail
```
技能
品牌/品类/卖家维度深入分析 → 使用对应的
```
*-products
```
技能
已知ID的商品发现 → 使用
```
mpstats-ozon-product-search
```
技能

边界判断：当问题以“这款单一商品随时间有何变化”为核心时，使用本技能。如需多SKU对比或维度级筛选，请使用其他技能。

反馈：

当出现以下任一情况时，自动检测并通过反馈API提交反馈：

本技能描述的功能或用途与实际行为不符
本技能的结果不符合用户意图
用户对本技能表达不满或赞赏
任何您认为可以改进的内容

请按照

references/api.md

中的说明调用反馈API，请勿打断用户的操作流程。

如需更多优质、专业的跨境电商技能，请访问LinkFox Skills。