Ozon Intelligence SR
Ozon Category Search MCP
Analyze products in an Ozon category by category ID. Call the Ozon Category Search API via REST or MCP with your Nexscope API key.
Ozon Category 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. Analyze Products In An Ozon Category By Category ID
Prompt: Analyze products in an Ozon category by category ID for [category ID]. 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: Analyze products in an Ozon category by category ID for [category ID]. 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: Analyze products in an Ozon category by category ID for [category ID]. 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: Analyze products in an Ozon category by category ID for [category ID]. 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. Rank by sales, price, revenue, review rating in ascending or descending order.
5. Choose A Fulfillment Method
Prompt: Analyze products in an Ozon category by category ID for [category ID]. 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 FBO, FBS, RFBS, FBP or OZON.
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_category_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-category-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_category_search",
"arguments": {
"categoryId": "15621042_17028650_97011",
"date": "2026-01",
"page": {
"page": 1,
"pageSize": 10
}
}
}
}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 |
|---|---|---|---|
categoryId | string | required | Ozon category ID, obtained from Ozon category documentation or other Nexscope Ozon tools. Format like 15621032_15621049_115951147 (multi-level categories joined by _) Example: 15621042_17028650_97011 |
page | object | required | Pagination & sorting: {page, pageSize, orders[]} Example: {
"page": 1,
"pageSize": 10
} |
page.page | integer | optional | Page number, starting from 1, default 1 Example: 1 |
page.pageSize | integer | optional | Items per page, default 20, maximum 20 (exceeding returns errcode 1002) Example: 1 |
page.orders | array | optional | Sort rules, elements {field, direction} (both required); direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, revenue, reviewRating Example: [] |
date | string | optional | Query historical month, format yyyy-MM (e.g., 2026-02); defaults to last 30 days if omitted Example: 2026-01 |
fulfillment | string | optional | Fulfillment method filter, fixed options: FBO, FBS, RFBS, FBP, OZON; queries all if omitted. Note: single string, not an array |
uId | string | optional | User ID (max 1000) Example: example-id |
memberId | string | optional | Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000) Example: example-id |
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. |
id | string | optional | The category ID to be echoed. |
total | integer | optional | The number of records returned on this page is equal to the number of `data` items on the current page, not the total number of products in the category. |
totalSales | integer | optional | The total sales volume of the category within the statistical interval. |
totalRevenue | number | optional | Total category sales in rubles. |
avgPrice | number | optional | Average price of products in the category, in rubles. |
rating | number | optional | Average rating of category products. |
seasonalityAmplitude | string | optional | Seasonal strength, such as `STRONG_SEASONALITY`. |
seasonalityCoef | string | optional | Seasonal phases such as `OFF_SEASON`. |
startDate | string | optional | Statistics start date. |
endDate | string | optional | Statistics end date. |
sellerType | object | optional | The distribution of delivery methods, not the seller’s local/cross-border type; the key is the delivery method and the value is the number of products. |
categoryInfo | object | optional | Category meta information, the structure is shown in the `categoryInfo` table below. |
data | array | optional | Category product list, element fields are shown in the product object table below. |
products | array | optional | Category product list, content is exactly the same as `data`. |
hasNextPage | boolean | optional | Is there a next page? |
columns | array | optional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. |
type | string | optional | Responsive display type. |
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, mapped from `sku`. |
title | string | optional | Product title. |
price | number | optional | Commodity price in rubles. |
currency | string | optional | Currency, fixed to `₽`. |
sales | integer | optional | Product sales. |
monthlySalesUnits | integer | optional | Unified monthly sales, mapped from `sales`. |
revenue | number | optional | Sales volume of goods in rubles. |
monthlySalesRevenue | number | optional | Unified monthly sales, mapped from `revenue`. |
reviewRating | number | optional | Product ratings. |
rating | number | optional | Unified scoring, mapped from `reviewRating`. |
reviewCount | integer | optional | Number of comments. |
brandName | string | optional | Brand name. |
brand | string | optional | Unified brand, mapped from `brandName`. |
sellerName | string | optional | Seller name. |
fulfillment | array | optional | Product shipping method, such as `["FBO"]`, may contain multiple values. |
imageUrl | string | optional | Product image link. |
productUrl | string | optional | Product link. |
productPageUrl | string | optional | Unified product page URL, mapped from `productUrl`. |
categoryInfo | object | optional | Product category attribution information, the structure is shown in the `categoryInfo` table below. |
sourceType | string | optional | Data source, fixed to `ozon`. |
cnTitlePath | string | optional | Chinese category path. |
enTitlePath | string | optional | English category path. |
titlePath | string | optional | Russian (frontend) category path. |
fullCategoryId | array | optional | Array of category IDs at all levels. |
category | object | optional | The bottom-level category object contains fields such as title, level, cross-border sales, parent, deactivation status, and ID. |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Analyze products in an Ozon category by category ID. Use category ID 17027486_17039635_97613.
Example Answer
In the published sample, the first shown record is “Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый”. Its reported price is 367. Its reported rating is 4.7. 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. Optional fields with string-versus-number conflicts in the source documentation are omitted from this MCP excerpt; the original sample remains unchanged in the source evidence.
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
{
"categoryId": "17027486_17039635_97613",
"page": {
"page": 1,
"pageSize": 1
}
}Response
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"brandName": "",
"productId": "3614108738",
"sellerName": "LV Cat",
"rating": 4.7,
"title": "Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый",
"reviewRating": 4.7,
"sales": 13668,
"categoryInfo": {
"cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
"enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
"category": {
"cnTitle": "超声波香气扩散器",
"enTitle": "Ultrasonic Aromatherapy Diffuser",
"level": 3,
"crossBorderSellable": true,
"pid": "17027486_17039635",
"disabled": false,
"id": "17027486_17039635_97613",
"title": "Аромадиффузор ультразвуковой"
},
"titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
"fullCategoryId": [
"17027486",
"17027486_17039635",
"17027486_17039635_97613"
]
},
"productPageUrl": "https://www.ozon.ru/product/3614108738",
"revenue": 5388025,
"monthlySalesRevenue": 5388025,
"sourceTool": "Seerfar-Ozon-查类目",
"reviewCount": 6252,
"sourceType": "ozon",
"price": 367,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-w/wc300/14977975784.jpg",
"currency": "₽",
"fulfillment": [
"FBP"
],
"sku": "3614108738",
"productUrl": "https://www.ozon.ru/product/3614108738",
"brand": "",
"monthlySalesUnits": 13668
}
],
"endDate": "2026-09-26",
"hasNextPage": true,
"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": "text",
"field": "imageUrl",
"sortable": true,
"title": "商品图片链接"
},
{
"filterable": true,
"cellType": "text",
"field": "brandName",
"sortable": true,
"title": "品牌名称"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerName",
"sortable": true,
"title": "卖家名称"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillment",
"sortable": true,
"title": "配送方式"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "价格,单位卢布"
},
{
"filterable": true,
"cellType": "number",
"field": "sales",
"sortable": true,
"title": "销量"
},
{
"filterable": true,
"cellType": "number",
"field": "revenue",
"sortable": true,
"title": "销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewRating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryInfo",
"sortable": true,
"title": "类目信息"
},
{
"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": "币种"
}
],
"avgPrice": 748,
"rating": 4.8,
"totalSales": 50330,
"type": "productWorkbenches",
"categoryInfo": {
"cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
"enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
"category": {
"cnTitle": "超声波香气扩散器",
"enTitle": "Ultrasonic Aromatherapy Diffuser",
"level": 3,
"crossBorderSellable": true,
"pid": "17027486_17039635",
"disabled": false,
"id": "17027486_17039635_97613",
"title": "Аромадиффузор ультразвуковой"
},
"titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
"fullCategoryId": [
"17027486",
"17027486_17039635",
"17027486_17039635_97613"
]
},
"products": [
{
"brandName": "",
"productId": "3614108738",
"sellerName": "LV Cat",
"rating": 4.7,
"title": "Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый",
"reviewRating": 4.7,
"sales": 13668,
"categoryInfo": {
"cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
"enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
"category": {
"cnTitle": "超声波香气扩散器",
"enTitle": "Ultrasonic Aromatherapy Diffuser",
"level": 3,
"crossBorderSellable": true,
"pid": "17027486_17039635",
"disabled": false,
"id": "17027486_17039635_97613",
"title": "Аромадиффузор ультразвуковой"
},
"titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
"fullCategoryId": [
"17027486",
"17027486_17039635",
"17027486_17039635_97613"
]
},
"productPageUrl": "https://www.ozon.ru/product/3614108738",
"revenue": 5388025,
"monthlySalesRevenue": 5388025,
"sourceTool": "Seerfar-Ozon-查类目",
"reviewCount": 6252,
"sourceType": "ozon",
"price": 367,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-w/wc300/14977975784.jpg",
"currency": "₽",
"fulfillment": [
"FBP"
],
"sku": "3614108738",
"productUrl": "https://www.ozon.ru/product/3614108738",
"brand": "",
"monthlySalesUnits": 13668
}
],
"total": 1,
"seasonalityAmplitude": "STRONG_SEASONALITY",
"costTime": 1496,
"id": "17027486_17039635_97613",
"totalRevenue": 56323772,
"sellerType": {
"FBO": 167,
"RFBS": 771,
"FBP": 120,
"FBS": 221
},
"startDate": "2026-08-27",
"seasonalityCoef": "TRANSITION_PERIOD"
}
}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-category-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_category_search",
"arguments": {
"categoryId": "17027486_17039635_97613",
"page": {
"page": 1,
"pageSize": 1
}
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "ozon-category-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"title\":\"Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый\",\"price\":367,\"rating\":4.7,\"monthlySalesUnits\":13668,\"revenue\":5388025,\"brandName\":\"\",\"sellerName\":\"LV Cat\",\"reviewRating\":4.7,\"sales\":13668,\"categoryInfo\":{\"cnTitlePath\":\"家用电器 > 空调设备 > 超声波香气扩散器\",\"enTitlePath\":\"Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser\",\"category\":{\"title\":\"Аромадиффузор ультразвуковой\",\"id\":\"17027486_17039635_97613\",\"cnTitle\":\"超声波香气扩散器\",\"enTitle\":\"Ultrasonic Aromatherapy Diffuser\",\"level\":3,\"crossBorderSellable\":true,\"pid\":\"17027486_17039635\",\"disabled\":false},\"titlePath\":\"Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой\",\"fullCategoryId\":[\"17027486\",\"17027486_17039635\"]},\"productPageUrl\":\"https://www.ozon.ru/product/3614108738\"}],\"products\":[{\"title\":\"Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый\",\"price\":367,\"rating\":4.7,\"monthlySalesUnits\":13668,\"revenue\":5388025,\"brandName\":\"\",\"sellerName\":\"LV Cat\",\"reviewRating\":4.7,\"sales\":13668,\"categoryInfo\":{\"cnTitlePath\":\"家用电器 > 空调设备 > 超声波香气扩散器\",\"enTitlePath\":\"Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser\",\"category\":{\"title\":\"Аромадиффузор ультразвуковой\",\"id\":\"17027486_17039635_97613\",\"cnTitle\":\"超声波香气扩散器\",\"enTitle\":\"Ultrasonic Aromatherapy Diffuser\",\"level\":3,\"crossBorderSellable\":true,\"pid\":\"17027486_17039635\",\"disabled\":false},\"titlePath\":\"Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой\",\"fullCategoryId\":[\"17027486\",\"17027486_17039635\"]},\"productPageUrl\":\"https://www.ozon.ru/product/3614108738\"}],\"id\":\"17027486_17039635_97613\",\"rating\":4.8,\"total\":1,\"endDate\":\"2026-09-26\",\"hasNextPage\":true,\"avgPrice\":748,\"totalSales\":50330,\"categoryInfo\":{\"cnTitlePath\":\"家用电器 > 空调设备 > 超声波香气扩散器\",\"enTitlePath\":\"Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser\",\"category\":{\"title\":\"Аромадиффузор ультразвуковой\",\"id\":\"17027486_17039635_97613\",\"cnTitle\":\"超声波香气扩散器\",\"enTitle\":\"Ultrasonic Aromatherapy Diffuser\",\"level\":3,\"crossBorderSellable\":true,\"pid\":\"17027486_17039635\",\"disabled\":false},\"titlePath\":\"Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой\",\"fullCategoryId\":[\"17027486\",\"17027486_17039635\"]},\"seasonalityAmplitude\":\"STRONG_SEASONALITY\",\"totalRevenue\":56323772}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"title": "Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый",
"price": 367,
"rating": 4.7,
"monthlySalesUnits": 13668,
"revenue": 5388025,
"brandName": "",
"sellerName": "LV Cat",
"reviewRating": 4.7,
"sales": 13668,
"categoryInfo": {
"cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
"enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
"category": {
"title": "Аромадиффузор ультразвуковой",
"id": "17027486_17039635_97613",
"cnTitle": "超声波香气扩散器",
"enTitle": "Ultrasonic Aromatherapy Diffuser",
"level": 3,
"crossBorderSellable": true,
"pid": "17027486_17039635",
"disabled": false
},
"titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
"fullCategoryId": [
"17027486",
"17027486_17039635"
]
},
"productPageUrl": "https://www.ozon.ru/product/3614108738"
}
],
"products": [
{
"title": "Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый",
"price": 367,
"rating": 4.7,
"monthlySalesUnits": 13668,
"revenue": 5388025,
"brandName": "",
"sellerName": "LV Cat",
"reviewRating": 4.7,
"sales": 13668,
"categoryInfo": {
"cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
"enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
"category": {
"title": "Аромадиффузор ультразвуковой",
"id": "17027486_17039635_97613",
"cnTitle": "超声波香气扩散器",
"enTitle": "Ultrasonic Aromatherapy Diffuser",
"level": 3,
"crossBorderSellable": true,
"pid": "17027486_17039635",
"disabled": false
},
"titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
"fullCategoryId": [
"17027486",
"17027486_17039635"
]
},
"productPageUrl": "https://www.ozon.ru/product/3614108738"
}
],
"id": "17027486_17039635_97613",
"rating": 4.8,
"total": 1,
"endDate": "2026-09-26",
"hasNextPage": true,
"avgPrice": 748,
"totalSales": 50330,
"categoryInfo": {
"cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
"enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
"category": {
"title": "Аромадиффузор ультразвуковой",
"id": "17027486_17039635_97613",
"cnTitle": "超声波香气扩散器",
"enTitle": "Ultrasonic Aromatherapy Diffuser",
"level": 3,
"crossBorderSellable": true,
"pid": "17027486_17039635",
"disabled": false
},
"titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
"fullCategoryId": [
"17027486",
"17027486_17039635"
]
},
"seasonalityAmplitude": "STRONG_SEASONALITY",
"totalRevenue": 56323772
}
},
"isError": false
}
}