Ozon Intelligence SR
Ozon Product Report Search MCP
Filter Ozon products by sales, revenue, growth, conversion, price, ratings, margin, returns, ads, seller, and fulfillment metrics. Call it via REST API or MCP.
Ozon Product Report Search AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Find Ozon Products Matching My Selection Criteria
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Show the available results and clearly identify missing information. Retrieve page 1 with up to 20 results and ask before continuing to another page.
2. Review A Specific Reporting Period
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data. Retrieve page 1 with up to 20 results and ask before continuing to another page.
3. Continue The Results Within A Page Limit
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Start at [my selected page] and request no more than 20 results. Ask before requesting another page and do not describe one page as the complete dataset.
4. Prioritize The Results For Review
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period. Retrieve page 1 with up to 20 results and ask before continuing to another page.
5. Find Matches By Monthly Sales
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen monthly sales range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
6. Find Matches By Sales Growth-Rate
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen sales growth-rate range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
7. Find Matches By Monthly Revenue Range In Rub
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen monthly revenue range in rub range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
8. Find Matches By Price Range In Rub
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen price range in rub range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
9. Find Matches By Cart Conversion-Rate
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen cart conversion-rate range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
10. Find Matches By Rating Range From 0 To 5
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen rating range from 0 to 5 range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
11. Find Matches By Review-Count
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen review-count range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
12. Find Matches By Question-And-Answer Count
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen question-and-answer count range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
13. Find Matches By Variant-Count
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen variant-count range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
14. Find Matches By Advertising Cost-Share
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen advertising cost-share range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
15. Find Matches By Gross-Margin
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen gross-margin range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
16. Find Matches By Return And Cancellation-Rate
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen return and cancellation-rate range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
17. Find Matches By Weight Range In Grams
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen weight range in grams range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
18. Find Matches By Volume Range In Liters
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Limit results to [my chosen volume range in liters range]. Keep the lower and upper bounds consistent and show only the matching records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
19. Search Several Product Terms
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Search for [my product terms] using the chosen matching rule and keep the query scope clear. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
20. Focus On Selected Categories
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Restrict the research to [my selected category IDs] and keep unrelated categories out of the results. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
21. Find Products From Selected Sellers
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Focus on [my selected sellers] and show which returned products belong to them. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
22. Focus On Selected Brands
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Use [my brand selection] to narrow the product results. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
23. Choose A Fulfillment Method
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Use [my preferred supported fulfillment methods] to narrow the research and keep fulfillment types distinguishable. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page. For this selection, choose OZON, FBO, FBS, RFBS or FBP.
24. Find New, Genuine Or Bestselling Products
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Use [my chosen new-product, genuine-product or bestseller labels] to narrow the results. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page. For this selection, choose new products, genuine products or best sellers.
25. Narrow Results By Listing Time
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Use [my selected listing time] to narrow the results. Report only what the selected records support. Retrieve page 1 with up to 20 results and ask before continuing to another page. For this selection, choose last30days, last90days, last180days, last year or last two years.
26. Review Variants Together Or Separately
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Show variants [merged or separately], according to my preference, so I do not accidentally count a product family twice. Summarize only the returned records. Retrieve page 1 with up to 20 results and ask before continuing to another page.
27. Narrow Results By Tag Word
Prompt: Find Ozon products matching my selection criteria for [SKUs]. Use [my selected tag word] to narrow the results. Report only what the selected records support. Retrieve page 1 with up to 20 results and ask before continuing to another page.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_ozon_product_report_searchhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "ozon-product-report-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_product_report_search",
"arguments": {
"page": {
"page": 1,
"pageSize": 20
},
"skus": [
1664362124
]
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
page | object | required | Nonempty pagination and sorting object: {page, pageSize, orders[]}. Omitted nested defaults are not inserted. Ranges accept optional finite bounds and require min <= max; numeric strings and optional null remain backend compatibility extensions. Example: {
"page": 1,
"pageSize": 20
} |
page.page | integer | optional | Page number, starting from 1, default 1 Example: 1 |
page.pageSize | integer | optional | Items per page, default 20 Example: 20 |
page.orders | array | optional | Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending). field is a metric field in the response (e.g., sales, revenue, price, reviewRating, reviewCount, salesRate) Example: [
{
"direction": "DESC",
"field": "sales"
}
] |
skus | array | optional | SKU array (max 10), for precise lookup of specified products Example: [
1664362124
] |
keywords | array | optional | Keyword array, filters by product title Example: [] |
categoryIds | array | optional | Category ID array (Nexscope category IDs, not category names) Example: [] |
sellerName | array | optional | Seller name array Example: [] |
brand | object | optional | Brand filter: {brandName: array<string>, type: integer}; type takes 0 include brand, 1 exclude brand, 2 unbranded Example: {} |
fulfillment | array | optional | Fulfillment method array, fixed options: OZON, FBO, FBS, RFBS, FBP Example: [] |
labels | array | optional | Label array, fixed options: 0 new product, 1 genuine product, 2 best seller Example: [
2
] |
creationDate | integer | optional | Listing time filter (months), fixed options: 1 last 30 days, 3 last 90 days, 6 last 180 days, 12 last year, 24 last two years; no filtering if omitted Example: 1 |
variationsMerge | integer | optional | Whether to merge variants: 0 do not merge, 1 merge Example: 1 |
searchDate | string | optional | Query date yyyy-MM-dd. Omit for a rolling last-30-days period; provide a date to query the preceding complete historical month (2026-04-01 selects March 2026), not month-to-date. Example: 2026-04-01 |
tag | string | optional | Tag word |
uId | string | optional | User ID Example: example-id |
memberId | string | optional | Member ID (a unique member identifier; data is attributed to memberId) Example: example-id |
monthlySales | object | optional | Monthly sales range: {min, max}; either bound may be omitted Example: {
"min": 5000
} |
monthlySalesRate | object | optional | Sales growth-rate range: {min, max}; either bound may be omitted Example: {
"min": 10
} |
monthlyRevenue | object | optional | Monthly revenue range in RUB: {min, max}; either bound may be omitted Example: {
"min": 100000
} |
price | object | optional | Price range in RUB: {min, max}; either bound may be omitted Example: {
"max": 500
} |
convToCartPdp | object | optional | Cart conversion-rate range: {min, max}; either bound may be omitted Example: {
"min": 20
} |
reviewRating | object | optional | Rating range from 0 to 5: {min, max}; either bound may be omitted Example: {
"min": 4
} |
reviewCount | object | optional | Review-count range: {min, max}; either bound may be omitted Example: {
"min": 100
} |
questionsAndAnswers | object | optional | Question-and-answer count range: {min, max}; either bound may be omitted Example: {
"min": 1
} |
variants | object | optional | Variant-count range: {min, max}; either bound may be omitted Example: {
"min": 1
} |
drr | object | optional | Advertising cost-share range: {min, max}; either bound may be omitted Example: {
"max": 20
} |
grossMargin | object | optional | Gross-margin range: {min, max}; either bound may be omitted Example: {
"min": 10
} |
returnCancellationRate | object | optional | Return and cancellation-rate range: {min, max}; either bound may be omitted Example: {
"max": 10
} |
weight | object | optional | Weight range in grams: {min, max}; either bound may be omitted. The supplier does not specify whether packaging is included. Example: {
"max": 1000
} |
volume | object | optional | Volume range in liters: {min, max}; either bound may be omitted. The supplier does not specify whether this measures the item or parcel. Example: {
"max": 10
} |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | Return code, `"200"` indicates success; returned when successful. |
errcode | integer | optional | Error code, `200` indicates success; only this field may be returned when there is a business error. |
msg | string | optional | Message; Success was `ok`. |
errmsg | string | optional | Error message; success is `ok`, business error is a reason description. |
total | integer | optional | The total number of matching records, not the number of entries on the current page; it may reach tens of millions without filtering. |
data | array | optional | Product report data, element fields are shown in the multiple field tables below. |
products | array | optional | Product report data is completely consistent with the content of `data`. |
columns | array | optional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. |
type | string | optional | Response display type, such as `productWorkbenches`. |
costTime | integer | optional | The interface consumes time in milliseconds. |
costToken | integer | optional | The number of tokens consumed. |
sku | integer | optional | Product SKU. |
productId | integer | optional | Unified product ID, equal to `sku`. |
title | string | optional | Product title, original Russian text. |
imageUrl | string | optional | Product main image URL. |
productUrl | string | optional | Product link. |
productPageUrl | string | optional | Unified product page URL, equal to `productUrl`. |
currency | string | optional | Currency, fixed to `₽`. |
sourceType | string | optional | Data source, fixed to `ozon`. |
sales | integer | optional | Monthly sales volume. |
monthlySalesUnits | integer | optional | The unified monthly sales volume is equal to `sales`. |
revenue | number | optional | Monthly sales in rubles. |
monthlySalesRevenue | number | optional | Unified monthly sales, equal to `revenue`. |
missedRevenue | number | optional | Lost sales in rubles. |
price | number | optional | Price in rubles. |
convToCartPdp | number | optional | Shopping cart conversion rate, percentage. |
orderConversionRate | number | optional | Order conversion rate, percentage. |
salesRate | number | optional | Sales growth rate, percentage. |
revenueRate | number | optional | Sales growth rate, percentage. |
drr | number | optional | Advertising cost share, ratio. |
grossMargin | number | optional | Gross profit margin, percentage. |
returnCancellationRate | number | optional | Return cancellation rate, percentage. |
views | integer | optional | Views. |
reviewRating | number | optional | Rating, 0–5. |
rating | number | optional | Unified rating, equal to `reviewRating`. |
reviewCount | integer | optional | Number of comments. |
questionsAndAnswers | integer | optional | QA quantity. |
variants | integer | optional | Number of variants. |
fulfillment | array<string> | optional | Delivery method: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
weight | number | optional | Weight, unit g. |
volume | number | optional | Volume, unit L. |
upTime | integer | optional | Listing timestamp, milliseconds. |
upDays | integer | optional | Number of days on shelf. |
upMonths | integer | optional | Number of months on shelves. |
brandName | string | optional | Brand name. |
brand | string | optional | Unified brand, equal to `brandName`. |
brandId | integer | optional | Brand ID. |
brandUrl | string | optional | Brand link. |
sellerName | string | optional | Seller name. |
sellerId | integer | optional | Seller ID; Ozon self-operated may be negative. |
categoryInfo | object | optional | Category information and structure are shown in the table below. |
cnTitlePath | string | optional | Chinese category path. |
enTitlePath | string | optional | English category path. |
titlePath | string | optional | Russian category path. |
fullCategoryId | array<string> | optional | A hierarchical array of complete category IDs. |
category | object | optional | Category nodes, including `cnTitle`, `enTitle`, `title`, `level`, `id`, `pid`, `crossBorderSellable`, `disabled`. |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find Ozon products matching my selection criteria.
Example Answer
In the published sample, its reported total is 13. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"page": {
"page": 2,
"pageSize": 20,
"orders": [
{
"field": "sales",
"direction": "DESC"
}
]
},
"categoryIds": [
"17027486_17039638_91891"
],
"variationsMerge": 0,
"monthlySales": {
"min": 500,
"max": 900
}
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 13,
"data": [],
"costTime": 1181,
"columns": [
{
"filterable": true,
"cellType": "number",
"field": "sku",
"sortable": true,
"title": "商品SKU"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "productUrl",
"sortable": true,
"title": "商品链接"
},
{
"filterable": true,
"cellType": "number",
"field": "brandId",
"sortable": true,
"title": "品牌ID"
},
{
"filterable": true,
"cellType": "text",
"field": "brandName",
"sortable": true,
"title": "品牌名称"
},
{
"filterable": true,
"cellType": "text",
"field": "brandUrl",
"sortable": true,
"title": "品牌链接"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "商品图片链接"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerId",
"sortable": true,
"title": "卖家ID"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerName",
"sortable": true,
"title": "卖家名称"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillment",
"sortable": true,
"title": "配送方式"
},
{
"filterable": true,
"cellType": "number",
"field": "weight",
"sortable": true,
"title": "重量,单位g"
},
{
"filterable": true,
"cellType": "number",
"field": "questionsAndAnswers",
"sortable": true,
"title": "QA数量"
},
{
"filterable": true,
"cellType": "number",
"field": "upTime",
"sortable": true,
"title": "上架时间戳,毫秒"
},
{
"filterable": true,
"cellType": "number",
"field": "upDays",
"sortable": true,
"title": "上架天数"
},
{
"filterable": true,
"cellType": "number",
"field": "upMonths",
"sortable": true,
"title": "上架月数"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "价格,单位卢布"
},
{
"filterable": true,
"cellType": "number",
"field": "grossMargin",
"sortable": true,
"title": "毛利率"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewRating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "number",
"field": "sales",
"sortable": true,
"title": "销量"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRate",
"sortable": true,
"title": "销量增长率"
},
{
"filterable": true,
"cellType": "number",
"field": "revenue",
"sortable": true,
"title": "销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "revenueRate",
"sortable": true,
"title": "销售额增长率"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryInfo",
"sortable": true,
"title": "类目信息"
},
{
"filterable": true,
"cellType": "number",
"field": "views",
"sortable": true,
"title": "浏览量"
},
{
"filterable": true,
"cellType": "number",
"field": "convToCartPdp",
"sortable": true,
"title": "购物车转化率"
},
{
"filterable": true,
"cellType": "number",
"field": "orderConversionRate",
"sortable": true,
"title": "下单转化率"
},
{
"filterable": true,
"cellType": "number",
"field": "drr",
"sortable": true,
"title": "广告费用份额"
},
{
"filterable": true,
"cellType": "number",
"field": "returnCancellationRate",
"sortable": true,
"title": "退货取消率"
},
{
"filterable": true,
"cellType": "number",
"field": "missedRevenue",
"sortable": true,
"title": "损失销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "variants",
"sortable": true,
"title": "变体数"
},
{
"filterable": true,
"cellType": "number",
"field": "volume",
"sortable": true,
"title": "体积,单位L"
},
{
"filterable": true,
"cellType": "number",
"field": "productId",
"sortable": true,
"title": "统一商品ID"
},
{
"filterable": true,
"cellType": "text",
"field": "productPageUrl",
"sortable": true,
"title": "统一商品页URL"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "统一品牌"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "统一评分"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "统一月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesRevenue",
"sortable": true,
"title": "统一月销售额"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "数据源"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "币种"
}
],
"type": "productWorkbenches",
"products": []
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "ozon-product-report-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_product_report_search",
"arguments": {
"page": {
"page": 2,
"pageSize": 20,
"orders": [
{
"field": "sales",
"direction": "DESC"
}
]
},
"categoryIds": [
"17027486_17039638_91891"
],
"variationsMerge": 0,
"monthlySales": {
"min": 500,
"max": 900
}
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "ozon-product-report-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[],\"products\":[],\"total\":13}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [],
"products": [],
"total": 13
}
},
"isError": false
}
}