📦 Mpstats Ozon Product Search — Mpstats Ozon Product 搜索

MPSTATS Ozon Product 搜索

This 技能 搜索es Ozon (Russia) products in the MPSTATS 分析 database by Russian keyword, SKU 列出, brand name, or seller name. It is the entry point for Ozon product discovery and competitor lookup — down流 drill-downs (brand/category/seller/detAIl/trend) typically 启动 from the IDs returned here.

Core Concepts

MPSTATS Ozon coverage: Ozon is Russia's largest general-category marketplace. MPSTATS 索引es Ozon product 列出ings and sales 历史. Per the official 输出模式, this 端点 returns the full Ozon product card (身份 + sales, price, stock, rating, turnover, lost-profit, revenue-分享, etc. — 39 fields total), 分享d with the brand / category / seller drill-down 端点s. In practice the 端点's primary use is discovery — resolving a keyword / SKU / brand / seller into products — and 运行time may leave metric fields s解析 depending on coverage and the 启动Date/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 输入 rule: The 输入 模式 marks all four 过滤器s as optional, but the 工具's business rule requires at least one of keyword / productIds / brandNames / sellerNames to be supplied. The four can be combined to narrow 结果s.

Parameters Parameter Type Required Description keyword string conditional Russian 搜索 keyword, e.g., кроссовки (sneakers) productIds array conditional Ozon SKU 列出 brandNames array conditional Brand display names (Russian or Latin) sellerNames array conditional Seller display names (Russian) 启动Date string no Stats window 启动, 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, 启动s at 1 pageSize integer no Rows per page, 1-100, default 100

At least one of keyword / productIds / brandNames / sellerNames must be supplied.

API Usage

This 工具 calls the LinkFox 工具 gateway API. See references/API.md for calling conventions, 请求 parameters, 响应 structure, and error codes. You can also 执行 scripts/mpstats_ozon_product_搜索.py directly for ad-hoc queries.

Usage Examples

• Keyword 搜索 — sneakers in Russian

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

• SKU batch reverse lookup

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

• Brand-scoped discovery

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

• Seller-scoped discovery

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

• Dated window for period-specific 搜索

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

How to ChAIn with Other Ozon 技能s Keyword → drill-down: 搜索 → pick productId → call mpstats-ozon-product-detAIl (batch 指标) or mpstats-ozon-product-trend (single-SKU time-series). Brand discovery → brand drill-down: Use this 技能 to confirm the exact brand display name, then call mpstats-ozon-brand-products for full sales / stock / rating 指标. Seller scouting → seller drill-down: Confirm the seller via this 技能, read the sellerId from the 结果, then call mpstats-ozon-seller-products for the seller's full SKU map. Display Rules Lead with 身份 columns — productId, title, brand, sellerName should headline the table since this 端点 is primarily a discovery step. 添加 price / monthlySalesUnits / rating only when those fields are actually populated in the 响应. Russian titles — preserve the original Russian title; optionally offer an English or Chinese translation on user 请求. 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 指标 — a missing monthlySalesUnits here is not "zero sales"; if the user wants hard numbers, 路由 to mpstats-ozon-product-detAIl (single SKU or batch card) or the *-products drill-down 端点s. Error handling — when code / errcode is non-200, explAIn the reason from msg / errmsg and suggest adjusting 输入s (supply at least one of the four 过滤器s, use Russian, narrow date range). 导入ant Limitations At least one 过滤器 required — empty payloads are rejected by the 工具's business rule even though required is empty in 输入模式. Russian / Latin only — non-Russian keywords generally return empty 结果s. Date range — endDate cannot be today or a future date; data is T-1. 结果 cap per page — pageSize max is 100; paginate for larger 设置s. Metric-field sparsity — the 模式 declares a full product card, but this 端点 often returns only 身份 fields. Treat price / sales / rating here as best-effort, not contractual. User Expression & Scenario Quick Reference

应用licable — Ozon product discovery / 身份 resolution:

Us