linkfox-mpstats-ozon-product-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MPSTATS Ozon Product Search

MPSTATS Ozon 商品搜索

This skill searches Ozon (Russia) products in the MPSTATS analytics database by Russian keyword, SKU list, brand name, or seller name. It is the entry point for Ozon product discovery and competitor lookup — downstream drill-downs (brand/category/seller/detail/trend) typically start from the IDs returned here.

本技能可通过俄语关键词、SKU列表、品牌名或卖家名，在MPSTATS分析数据库中检索俄罗斯Ozon平台的商品。它是Ozon商品选品与竞品反查的入口——后续的深度分析（品牌/品类/卖家/详情/趋势）通常都从这里返回的商品ID展开。

Core Concepts

核心概念

MPSTATS Ozon coverage: Ozon is Russia's largest general-category marketplace. MPSTATS indexes Ozon product listings and sales history. Per the official outputSchema, this endpoint returns the full Ozon product card (identity + sales, price, stock, rating, turnover, lost-profit, revenue-share, etc. — 39 fields total), shared with the brand / category / seller drill-down endpoints. In practice the endpoint's primary use is discovery — resolving a keyword / SKU / brand / seller into products — and runtime may leave metric fields sparse depending on coverage and the

startDate/endDate

window.

Language requirement: Keywords, brand names, and seller names must be in Russian (Cyrillic) — or the Latin-script form actually used on the Ozon storefront (e.g.,

adidas

). If the user supplies an English or Chinese keyword, translate it to Russian first and note the translation.

At-least-one input rule: The input schema marks all four filters as optional, but the tool's business rule requires at least one of

keyword

productIds

brandNames

sellerNames

to be supplied. The four can be combined to narrow results.

MPSTATS Ozon覆盖范围：Ozon是俄罗斯最大的综合类电商平台。MPSTATS会收录Ozon的商品列表及销售历史。根据官方输出Schema，该接口返回完整的Ozon商品卡片（包含身份信息+销量、价格、库存、评分、营业额、损失利润、营收占比等共39个字段），与品牌/品类/卖家深度分析接口共享数据。实际上，该接口的主要用途是商品发现——将关键词/SKU/品牌/卖家对应到具体商品，运行时可能会因数据覆盖范围及

startDate/endDate

时间窗口的不同，导致部分指标字段数据缺失。

语言要求：关键词、品牌名及卖家名必须为俄语（西里尔字母），或Ozon平台实际使用的拉丁字母形式（例如

adidas

）。若用户提供英文或中文关键词，需先将其翻译为俄语，并注明翻译内容。

至少一项输入规则：输入Schema标记四个筛选条件均为可选，但工具的业务规则要求必须提供

keyword

productIds

brandNames

sellerNames

中的至少一项。这四个条件可组合使用以缩小搜索范围。

Parameters

参数

Parameter	Type	Required	Description
keyword	string	conditional	Russian search keyword, e.g., `кроссовки` (sneakers)
productIds	array<integer\|string>	conditional	Ozon SKU list
brandNames	array<string>	conditional	Brand display names (Russian or Latin)
sellerNames	array<string>	conditional	Seller display names (Russian)
startDate	string	no	Stats window start, `YYYY-MM-DD` ; defaults to one year ago
endDate	string	no	Stats window end, `YYYY-MM-DD` ; defaults to yesterday, cannot be today or future
page	integer	no	Page number, starts at 1
pageSize	integer	no	Rows per page, 1-100, default 100

At least one of

keyword

productIds

brandNames

sellerNames

must be supplied.

参数	类型	必填	描述
keyword	string	条件必填	俄语搜索关键词，例如 `кроссовки` （运动鞋）
productIds	array<integer\|string>	条件必填	Ozon SKU列表
brandNames	array<string>	条件必填	品牌显示名称（俄语或拉丁字母）
sellerNames	array<string>	条件必填	卖家显示名称（俄语）
startDate	string	否	统计窗口开始日期，格式为 `YYYY-MM-DD` ；默认值为一年前
endDate	string	否	统计窗口结束日期，格式为 `YYYY-MM-DD` ；默认值为昨天，不能是今天或未来日期
page	integer	否	页码，从1开始
pageSize	integer	否	每页行数，范围1-100，默认值为100

必须提供

keyword

productIds

brandNames

sellerNames

中的至少一项。

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

directly for ad-hoc queries.

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

references/api.md

。你也可以直接执行

scripts/mpstats_ozon_product_search.py

进行临时查询。

Usage Examples

使用示例

1. Keyword search — sneakers in Russian

json

{"keyword": "кроссовки", "pageSize": 50}

2. SKU batch reverse lookup

json

{"productIds": [1786874757, 151623766, 142257239]}

3. Brand-scoped discovery

json

{"brandNames": ["adidas", "Xiaomi"], "keyword": "наушники"}

4. Seller-scoped discovery

json

{"sellerNames": ["ООО Ромашка"], "pageSize": 100}

5. Dated window for period-specific search

json

{"keyword": "футболка", "startDate": "2025-02-01", "endDate": "2025-02-28"}

1. 关键词搜索——俄语搜索运动鞋

json

{"keyword": "кроссовки", "pageSize": 50}

2. SKU批量反查

json

{"productIds": [1786874757, 151623766, 142257239]}

3. 指定品牌的商品发现

json

{"brandNames": ["adidas", "Xiaomi"], "keyword": "наушники"}

4. 指定卖家的商品发现

json

{"sellerNames": ["ООО Ромашка"], "pageSize": 100}

5. 指定时间窗口的特定时期搜索

json

{"keyword": "футболка", "startDate": "2025-02-01", "endDate": "2025-02-28"}

How to Chain with Other Ozon Skills

与其他Ozon技能的联动方式

Keyword → drill-down: Search → pick
```
productId
```
→ call
```
mpstats-ozon-product-detail
```
(batch metrics) or
```
mpstats-ozon-product-trend
```
(single-SKU time-series).
Brand discovery → brand drill-down: Use this skill to confirm the exact brand display name, then call
```
mpstats-ozon-brand-products
```
for full sales / stock / rating metrics.
Seller scouting → seller drill-down: Confirm the seller via this skill, read the
```
sellerId
```
from the result, then call
```
mpstats-ozon-seller-products
```
for the seller's full SKU map.

关键词→深度分析：搜索→选择
```
productId
```
→调用
```
mpstats-ozon-product-detail
```
（批量指标）或
```
mpstats-ozon-product-trend
```
（单个SKU的时间序列数据）。
品牌发现→品牌深度分析：使用本技能确认品牌的准确显示名称，然后调用
```
mpstats-ozon-brand-products
```
获取完整的销量/库存/评分指标。
卖家调研→卖家深度分析：通过本技能确认卖家信息，从结果中读取
```
sellerId
```
，然后调用
```
mpstats-ozon-seller-products
```
获取卖家的完整SKU清单。

Display Rules

展示规则

Lead with identity columns —
```
productId
```
,
```
title
```
,
```
brand
```
,
```
sellerName
```
should headline the table since this endpoint is primarily a discovery step. Add
```
price
```
/
```
monthlySalesUnits
```
/
```
rating
```
only when those fields are actually populated in the response.
Russian titles — preserve the original Russian title; optionally offer an English or Chinese translation on user request.
Pagination — when
```
total
```
exceeds the page size, tell the user the total count and suggest the next page or a narrower keyword.
Do not extrapolate on null metrics — a missing
```
monthlySalesUnits
```
here is not "zero sales"; if the user wants hard numbers, route to
```
mpstats-ozon-product-detail
```
(single SKU or batch card) or the
```
*-products
```
drill-down endpoints.
Error handling — when
```
code
```
/
```
errcode
```
is non-200, explain the reason from
```
msg
```
/
```
errmsg
```
and suggest adjusting inputs (supply at least one of the four filters, use Russian, narrow date range).

优先展示身份列——
```
productId
```
、
```
title
```
、
```
brand
```
、
```
sellerName
```
应作为表格的核心内容，因为该接口主要用于商品发现。仅当响应中实际包含
```
price
```
/
```
monthlySalesUnits
```
/
```
rating
```
字段时，才添加这些内容。
俄文标题——保留原始俄文标题；可根据用户请求提供英文或中文翻译。
分页处理——当
```
total
```
（总条数）超过每页行数时，告知用户总条数，并建议查询下一页或缩小关键词范围。
不要对空指标进行推断——此处缺失的
```
monthlySalesUnits
```
并不代表“零销量”；若用户需要准确数据，引导其使用
```
mpstats-ozon-product-detail
```
（单个或批量商品卡片）或
```
*-products
```
深度分析接口。
错误处理——当
```
code
```
/
```
errcode
```
不为200时，根据
```
msg
```
/
```
errmsg
```
解释原因，并建议调整输入（提供至少一项筛选条件、使用俄语、缩小日期范围）。

Important Limitations

重要限制

At least one filter required — empty payloads are rejected by the tool's business rule even though
```
required
```
is empty in inputSchema.
Russian / Latin only — non-Russian keywords generally return empty results.
Date range —
```
endDate
```
cannot be today or a future date; data is T-1.
Result cap per page —
```
pageSize
```
max is 100; paginate for larger sets.
Metric-field sparsity — the schema declares a full product card, but this endpoint often returns only identity fields. Treat price / sales / rating here as best-effort, not contractual.

至少需要一项筛选条件——即使输入Schema中标记为非必填，空请求也会被工具的业务规则拒绝。
仅支持俄语/拉丁字母——非俄语关键词通常会返回空结果。
日期范围限制——
```
endDate
```
不能是今天或未来日期；数据为T-1（前一天）。
单页结果上限——
```
pageSize
```
最大值为100；如需更多结果需分页查询。
指标字段数据缺失——Schema声明返回完整商品卡片，但该接口通常仅返回身份信息字段。此处的价格/销量/评分数据仅供参考，不保证完整性。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — Ozon product discovery / identity resolution:

User Says	Scenario
"Search Ozon for sneakers / headphones / ..."	Keyword discovery
"I have a list of Ozon SKUs, pull their names"	Batch SKU reverse lookup
"What does brand X sell on Ozon"	Brand-scoped candidate listing
"What does seller Y sell on Ozon"	Seller-scoped candidate listing
"Translate this keyword to Russian and search Ozon"	Cross-language discovery

Not applicable — Needs beyond discovery:

Reliable per-SKU sales / revenue / stock / rating metrics → use
```
mpstats-ozon-product-detail
```
(batch card) or the
```
*-products
```
drill-down skills.
Time-series trend for a single SKU → use
```
mpstats-ozon-product-trend
```
.
Wildberries or other non-Ozon Russian marketplaces → not covered here.
Category-tree navigation / Russian category path lookup → use
```
mpstats-ozon-category-products
```
with a known path.

Boundary judgment: If the user wants to find or identify Ozon products, start here. If they already have an ID or a dimension (brand / category / seller) and want metrics under it, go to the corresponding drill-down skill directly.

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商品发现/身份识别：

用户表述	场景
"在Ozon上搜索运动鞋/耳机/……"	关键词商品发现
"我有一组Ozon SKU，帮我获取它们的名称"	SKU批量反查
"品牌X在Ozon上卖什么产品"	指定品牌的候选商品列表
"卖家Y在Ozon上卖什么产品"	指定卖家的候选商品列表
"把这个关键词翻译成俄语并在Ozon上搜索"	跨语言商品发现

不适用场景——超出商品发现的需求：

获取可靠的单SKU销量/营收/库存/评分指标 → 使用
```
mpstats-ozon-product-detail
```
（批量商品卡片）或
```
*-products
```
深度分析技能。
单个SKU的时间序列趋势 → 使用
```
mpstats-ozon-product-trend
```
。
Wildberries或其他非Ozon的俄罗斯电商平台 → 不在本技能覆盖范围内。
品类树导航/俄罗斯品类路径查询 → 使用已知路径调用
```
mpstats-ozon-category-products
```
。

边界判断：如果用户想要查找或识别Ozon商品，从本技能开始。如果用户已经拥有商品ID或维度（品牌/品类/卖家）并想要获取其下的指标数据，直接使用对应的深度分析技能。

反馈机制：

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

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

按照

references/api.md

中的指定方式调用反馈API，不要打断用户的操作流程。

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