linkfox-mpstats-ozon-brand-products

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MPSTATS Ozon Brand Products

MPSTATS Ozon品牌商品工具

This skill drills into all Ozon (Russia) products sold under a given brand display name, returning each SKU's sales, revenue, price, rating, stock, turnover, lost profit, and more. Built for brand competitor audits, brand SKU structure analysis, and bestseller dissection.

本技能可深入查看Ozon（俄罗斯站点）指定品牌展示名称下的所有在售商品，返回每个SKU的销量、销售额、价格、评分、库存、周转、损失利润等数据。适用于品牌竞品审计、品牌SKU结构分析及爆款拆解。

Core Concepts

核心概念

Brand display name:

brandName

must match what's shown on the Ozon storefront — typically Russian (Cyrillic) or Latin (

adidas

Xiaomi

). Do not pass a category path, a seller ID, or an internal brand code here. If unsure of the exact spelling, resolve via

mpstats-ozon-product-search

first.

Filters are AND-combined: The

filters

array supports multiple numeric conditions ANDed together. Each filter is

{field, op, value, value2?}

. Common fields and operators are in the Filter Reference below.

Currency & rate: Default currency is RUB. Set

currency: "USD"

(or another code) to have monetary fields converted server-side;

currencyRate

lets you override the default rate if desired.

FBO / FBS mix:

includeFbs: true

folds FBS (seller-shipped) stock + sales into the numbers;

false

keeps them FBO-only.

品牌展示名称：

brandName

必须与Ozon店铺前台显示的名称一致——通常为俄语（西里尔字母）或拉丁字母（如

adidas

、

Xiaomi

）。请勿传入分类路径、卖家ID或内部品牌编码。若不确定准确拼写，请先通过

mpstats-ozon-product-search

工具确认。

筛选条件为逻辑与关系：

filters

数组支持多个数值条件的逻辑与组合。每个筛选条件格式为

{field, op, value, value2?}

。常用字段及运算符见下方筛选参考。

货币与汇率：默认货币为卢布（RUB）。设置

currency: "USD"

（或其他货币代码）可让系统在服务端转换货币字段；若需自定义汇率，可设置

currencyRate

参数覆盖默认汇率。

FBO/FBS混合统计：

includeFbs: true

会将FBS（卖家自发货）的库存和销量数据纳入统计；设为

false

则仅统计FBO（平台仓储发货）数据。

Parameters

参数说明

Parameter	Type	Required	Description
brandName	string	yes	Ozon brand display name (Russian or Latin)
startDate	string	no	Stats window start, `YYYY-MM-DD` ; latest = yesterday
endDate	string	no	Stats window end, `YYYY-MM-DD` ; latest = yesterday
page	integer	no	Page number, starts at 1
pageSize	integer	no	Rows per page, 1-100, default 100
sortField	string	no	snake_case column: `sales` , `revenue` , `final_price` , `balance` , `rating` , ...
sortDirection	string	no	`asc` or `desc`
currency	string	no	Currency code, default `RUB` ; e.g. `USD` , `EUR` , `CNY`
currencyRate	integer	no	Custom rate when non-default currency is used
includeFbs	boolean	no	Include FBS data
filters	array	no	Numeric filter conditions (see below)

参数名	类型	是否必填	描述
brandName	string	是	Ozon品牌展示名称（俄语或拉丁字母）
startDate	string	否	统计窗口开始日期，格式 `YYYY-MM-DD` ；默认最近为昨日
endDate	string	否	统计窗口结束日期，格式 `YYYY-MM-DD` ；默认最近为昨日
page	integer	否	页码，从1开始
pageSize	integer	否	每页行数，范围1-100，默认100
sortField	string	否	排序字段（蛇形命名）： `sales` 、 `revenue` 、 `final_price` 、 `balance` 、 `rating` 等
sortDirection	string	否	排序方向： `asc` （升序）或 `desc` （降序）
currency	string	否	货币代码，默认 `RUB` ；例如 `USD` 、 `EUR` 、 `CNY`
currencyRate	integer	否	使用非默认货币时的自定义汇率
includeFbs	boolean	否	是否包含FBS数据
filters	array	否	数值筛选条件（详见下文）

Filter Reference

筛选参考

Each

filters

entry:

{"field": "<snake_case>", "op": "<OP>", "value": <num>, "value2": <num?>}

Common fields:

sales

(monthly units),

final_price

(selling price RUB),

rating

(0-5),

comments

(review count),

balance

(stock),

revenue

(sales amount RUB),

days_in_stock

turnover_days

lost_profit

category_position

Operators:

GTE

LTE

GT

LT

EQ

NOT_EQ

BETWEEN

(requires

value2

as the upper bound).

每个

filters

条目格式：

{"field": "<蛇形命名字段>", "op": "<运算符>", "value": <数值>, "value2": <可选数值>}

。

常用字段：

sales

（月销量）、

final_price

（售价，卢布）、

rating

（评分，0-5）、

comments

（评论数）、

balance

（库存）、

revenue

（销售额，卢布）、

days_in_stock

（库存天数）、

turnover_days

（周转天数）、

lost_profit

（损失利润）、

category_position

（类目排名）。

运算符：

GTE

（大于等于）、

LTE

（小于等于）、

GT

（大于）、

LT

（小于）、

EQ

（等于）、

NOT_EQ

（不等于）、

BETWEEN

（介于两者之间，需指定

value2

作为上限）。

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_brand_products.py

directly for ad-hoc queries.

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

references/api.md

。也可直接执行

scripts/mpstats_ozon_brand_products.py

进行临时查询。

Usage Examples

使用示例

1. Top-50 by sales for brand
adidas

json

{
  "brandName": "adidas",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 50
}

2. High-rating, mid-price filter

json

{
  "brandName": "Xiaomi",
  "filters": [
    {"field": "rating", "op": "GTE", "value": 4.5},
    {"field": "final_price", "op": "BETWEEN", "value": 1000, "value2": 5000}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

3. USD-converted output

json

{
  "brandName": "Nike",
  "currency": "USD",
  "sortField": "revenue"
}

4. Include FBS + only in-stock items

json

{
  "brandName": "adidas",
  "includeFbs": true,
  "filters": [{"field": "balance", "op": "GT", "value": 0}]
}

5. Lost-profit hunters (out-of-stock pain)

json

{
  "brandName": "Nike",
  "filters": [{"field": "lost_profit", "op": "GTE", "value": 100000}],
  "sortField": "lost_profit",
  "sortDirection": "desc"
}

1. 查看adidas品牌销量Top50商品

json

{
  "brandName": "adidas",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 50
}

2. 筛选高评分、中等价位的商品

json

{
  "brandName": "Xiaomi",
  "filters": [
    {"field": "rating", "op": "GTE", "value": 4.5},
    {"field": "final_price", "op": "BETWEEN", "value": 1000, "value2": 5000}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

3. 以美元为单位输出数据

json

{
  "brandName": "Nike",
  "currency": "USD",
  "sortField": "revenue"
}

4. 包含FBS数据且仅显示有库存的商品

json

{
  "brandName": "adidas",
  "includeFbs": true,
  "filters": [{"field": "balance", "op": "GT", "value": 0}]
}

5. 查找损失利润较高的商品（缺货痛点分析）

json

{
  "brandName": "Nike",
  "filters": [{"field": "lost_profit", "op": "GTE", "value": 100000}],
  "sortField": "lost_profit",
  "sortDirection": "desc"
}

Display Rules

展示规则

Compact brand table — key columns:

productId

title

price

monthlySalesUnits

monthlySalesRevenue

rating

reviewCount

balance

turnoverDays

lostProfit

Revenue share context —
```
revenueSharePercent
```
is the SKU's share within this brand result set, 0-100; clarify the base when presenting.
Currency labeling — always state the currency in the table header; if
```
currency
```
was overridden, note "已按 USD 换算".
Russian titles — preserve original; translate on user request.
Pagination — report total and guide the user to next page or narrower filters when total exceeds the returned page.
No business advice — present the data; don't project future sales from a snapshot.

品牌数据精简表格 — 核心列：

productId

、

title

、

price

、

monthlySalesUnits

、

monthlySalesRevenue

、

rating

、

reviewCount

、

balance

、

turnoverDays

、

lostProfit

。

销售额占比说明 —
```
revenueSharePercent
```
为该SKU在本次品牌查询结果中的销售额占比（0-100）；展示时需明确统计基数。
货币标注 — 表格表头需始终标注货币类型；若自定义了
```
currency
```
参数，需注明“已按USD换算”。
俄文标题 — 保留原文；仅在用户要求时进行翻译。
分页提示 — 告知用户总数据量，当总数据量超过当前返回页数时，引导用户查看下一页或缩小筛选范围。
不提供商业建议 — 仅展示数据；不得基于快照数据预测未来销量。

Important Limitations

重要限制

Exact brand-name match — no fuzzy search; typos return empty results. Verify via
```
mpstats-ozon-product-search
```
if unsure.
Page cap — max 100 rows per page; paginate for larger brands.
Date window —
```
endDate
```
cannot be today or a future date (T-1 data).
Currency conversion — server-side; historical rates may differ slightly from the user's reference rate.
Russian-only titles — translate only when asked.

品牌名称精确匹配 — 不支持模糊搜索；拼写错误会返回空结果。若不确定名称，请先通过
```
mpstats-ozon-product-search
```
工具验证。
页数上限 — 每页最多100条数据；品牌商品较多时需分页查询。
日期范围限制 —
```
endDate
```
不能为今日或未来日期（仅支持昨日及之前的数据）。
货币转换 — 由服务端完成；历史汇率可能与用户参考汇率略有差异。
俄文标题 — 仅在用户要求时翻译。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — Brand-scoped Ozon product metrics:

User Says	Scenario
"Show me adidas's top-selling Ozon SKUs"	Brand bestseller drill
"What does Xiaomi sell on Ozon, sorted by revenue"	Brand revenue structure
"Which brand-X SKUs have rating ≥4.5 and stock >0"	Brand quality filter
"Are brand-X's stockouts causing big lost profit"	Lost-profit hunter
"Convert brand-X's Ozon sales to USD"	Currency-normalized audit

Not applicable — Needs beyond brand drill-down:

Unknown exact brand name → first use
```
mpstats-ozon-product-search
```
Category-level comparison across brands → use
```
mpstats-ozon-category-products
```
Seller-scoped analysis → use
```
mpstats-ozon-seller-products
```
Single-SKU time-series → use
```
mpstats-ozon-product-trend
```
Wildberries / other Russian marketplaces → not covered

Boundary judgment: Use this skill when the question centers on one brand and you want the per-SKU rollup under it. For "which brand dominates category X" use category drill-down and compare brand rows server-side.

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.

适用场景 — 品牌维度的Ozon商品指标查询：

用户表述	场景
"Show me adidas's top-selling Ozon SKUs"	品牌爆款拆解
"What does Xiaomi sell on Ozon, sorted by revenue"	品牌销售额结构分析
"Which brand-X SKUs have rating ≥4.5 and stock >0"	品牌优质库存商品筛选
"Are brand-X's stockouts causing big lost profit"	缺货损失利润分析
"Convert brand-X's Ozon sales to USD"	货币标准化审计

不适用场景 — 超出品牌下钻范围的需求：

未知精确品牌名称 → 先使用
```
mpstats-ozon-product-search
```
工具
跨品牌类目对比 → 使用
```
mpstats-ozon-category-products
```
工具
卖家维度分析 → 使用
```
mpstats-ozon-seller-products
```
工具
单个SKU时间趋势分析 → 使用
```
mpstats-ozon-product-trend
```
工具
Wildberries或其他俄罗斯电商平台 → 不在本技能覆盖范围内

边界判断 — 当问题聚焦于单个品牌且需要查看该品牌下各SKU的汇总数据时，使用本技能。若需查询“哪个品牌主导类目X”，请使用类目下钻工具并在服务端对比品牌数据。

反馈机制：

当出现以下情况时，自动通过Feedback API提交反馈：

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

请按照

references/api.md

中的规范调用反馈API，请勿打断用户流程。

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