Ozon Intelligence SR
Ozon Shop Search MCP
Analyze an Ozon shop's products by shop ID. Results come back as structured JSON. Call the Ozon Shop Search API via REST or MCP with your Nexscope API key.
Ozon Shop 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 An Ozon Shop'S Products By Shop ID
Prompt: Analyze an Ozon shop's products by shop ID for [record 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. Continue The Results Within A Page Limit
Prompt: Analyze an Ozon shop's products by shop ID for [record 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.
3. Prioritize The Results For Review
Prompt: Analyze an Ozon shop's products by shop ID for [record 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, review rating, upload time in ascending or descending order.
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_shop_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-shop-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_shop_search",
"arguments": {
"id": 1581151,
"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 |
|---|---|---|---|
id | integer | required | Shop (seller) ID, i.e., the sellerId returned by other Nexscope Ozon tools; negative values are Ozon platform self-operated sellers (e.g., -2 Ozon Express, -4 Ozon Fresh), positive values are third-party sellers Example: 1581151 |
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}; direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, reviewRating, upTime Example: [] |
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. |
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 items in the store. |
totalSales | integer | optional | The total sales volume of the store in the past 30 days. |
totalRevenue | integer | optional | Total store sales in rubles. |
dailySales | integer | optional | The average daily sales volume of the store. |
rating | number | optional | Store rating, 0–5. |
productCount | integer | optional | The total number of products in the store, the entire store, not the number of items on the current page. |
fulfillment | object | optional | The distribution of store delivery methods, the key is `FBO` / `FBS`, and the value is the number of corresponding products; it is different from the product-level delivery array. |
data | array | optional | Store product list, element fields are shown in the table below. |
products | array | optional | The store product list is completely consistent with the content of `data`. |
hasNextPage | boolean | optional | Is there a next page? |
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. |
productId | integer | optional | Unified product ID, mapped from `sku`. |
sku | integer | optional | Product SKU. |
rating | number | optional | Unified scoring, mapped from `reviewRating`. |
reviewRating | number | optional | Product ratings. |
weight | number | optional | Product weight, unit g. |
sales | integer | optional | Product sales in the past 30 days. |
monthlySalesUnits | integer | optional | Unified monthly sales, mapped from `sales`. |
upTime | integer | optional | Product shelf time, millisecond timestamp. |
price | number | optional | Commodity price in rubles. |
currency | string | optional | Currency, fixed to `₽`. |
imageUrl | string | optional | Unify the main image URL. |
fulfillment | array | optional | Product shipping method, such as `["FBO"]`, may contain multiple values. |
sellerType | integer | optional | Seller type: `0` local, `1` cross-border. |
returnCancellationRate | number | optional | Product return cancellation rate, percentage; may be missing for self-operated sellers on the Ozon platform. |
sourceType | string | optional | Data source, fixed to `ozon`. |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Analyze an Ozon shop's products by shop ID. Use record ID 2574278.
Example Answer
In the published sample, its reported price is 1947. Its reported rating is 4.7. Its reported monthly sales units is 160. 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
{
"id": 2574278,
"page": {
"page": 1,
"pageSize": 20,
"orders": [
{
"field": "sales",
"direction": "DESC"
}
]
}
}Response
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"productId": "5315093530",
"rating": 4.7,
"weight": 530,
"reviewRating": 4.7,
"sales": 160,
"upTime": "1785618000000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 24.7,
"sourceType": "ozon",
"price": 1947,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "5315093530",
"sellerType": 0,
"monthlySalesUnits": 160
},
{
"productId": 2011308439,
"rating": 4.8,
"weight": 375,
"reviewRating": 4.8,
"sales": 137,
"upTime": "1744059600000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 18.7,
"sourceType": "ozon",
"price": 1535,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": 2011308439,
"sellerType": 0,
"monthlySalesUnits": 137
},
{
"productId": "5315408758",
"rating": 4.4,
"weight": 340,
"reviewRating": 4.4,
"sales": 78,
"upTime": "1785618000000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 19.7,
"sourceType": "ozon",
"price": 1350,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-0/wc300/14422246380.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "5315408758",
"sellerType": 0,
"monthlySalesUnits": 78
},
{
"productId": "3142595615",
"rating": 4.9,
"weight": 400,
"reviewRating": 4.9,
"sales": 3,
"upTime": "1763758800000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 33.4,
"sourceType": "ozon",
"price": 1482,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-j/wc300/9078178987.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "3142595615",
"sellerType": 0,
"monthlySalesUnits": 3
},
{
"productId": "3142595707",
"rating": 4.9,
"weight": 400,
"reviewRating": 4.9,
"sales": 1,
"upTime": "1763758800000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 0,
"sourceType": "ozon",
"price": 1332,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-h/wc300/9078182873.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "3142595707",
"sellerType": 0,
"monthlySalesUnits": 1
}
],
"hasNextPage": false,
"columns": [
{
"filterable": true,
"cellType": "number",
"field": "sku",
"sortable": true,
"title": "商品SKU"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "商品价格"
},
{
"filterable": true,
"cellType": "number",
"field": "sales",
"sortable": true,
"title": "商品近30天销量"
},
{
"filterable": true,
"cellType": "number",
"field": "returnCancellationRate",
"sortable": true,
"title": "商品退货取消率"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewRating",
"sortable": true,
"title": "商品评分"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerType",
"sortable": true,
"title": "商品卖家类型,0本土,1跨境"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillment",
"sortable": true,
"title": "商品配送方式"
},
{
"filterable": true,
"cellType": "number",
"field": "weight",
"sortable": true,
"title": "商品重量,单位g"
},
{
"filterable": true,
"cellType": "number",
"field": "upTime",
"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": "imageUrl",
"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": "币种"
}
],
"dailySales": 13,
"rating": 4.8,
"totalSales": 379,
"type": "productWorkbenches",
"productCount": 5,
"products": [
{
"productId": "5315093530",
"rating": 4.7,
"weight": 530,
"reviewRating": 4.7,
"sales": 160,
"upTime": "1785618000000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 24.7,
"sourceType": "ozon",
"price": 1947,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "5315093530",
"sellerType": 0,
"monthlySalesUnits": 160
},
{
"productId": 2011308439,
"rating": 4.8,
"weight": 375,
"reviewRating": 4.8,
"sales": 137,
"upTime": "1744059600000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 18.7,
"sourceType": "ozon",
"price": 1535,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": 2011308439,
"sellerType": 0,
"monthlySalesUnits": 137
},
{
"productId": "5315408758",
"rating": 4.4,
"weight": 340,
"reviewRating": 4.4,
"sales": 78,
"upTime": "1785618000000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 19.7,
"sourceType": "ozon",
"price": 1350,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-0/wc300/14422246380.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "5315408758",
"sellerType": 0,
"monthlySalesUnits": 78
},
{
"productId": "3142595615",
"rating": 4.9,
"weight": 400,
"reviewRating": 4.9,
"sales": 3,
"upTime": "1763758800000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 33.4,
"sourceType": "ozon",
"price": 1482,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-j/wc300/9078178987.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "3142595615",
"sellerType": 0,
"monthlySalesUnits": 3
},
{
"productId": "3142595707",
"rating": 4.9,
"weight": 400,
"reviewRating": 4.9,
"sales": 1,
"upTime": "1763758800000",
"sourceTool": "Seerfar-Ozon-查店铺",
"returnCancellationRate": 0,
"sourceType": "ozon",
"price": 1332,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-h/wc300/9078182873.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
],
"sku": "3142595707",
"sellerType": 0,
"monthlySalesUnits": 1
}
],
"total": 5,
"costTime": 2498,
"totalRevenue": 533893,
"fulfillment": {
"FBO": 5
}
}
}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-shop-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_shop_search",
"arguments": {
"id": 2574278,
"page": {
"page": 1,
"pageSize": 20,
"orders": [
{
"field": "sales",
"direction": "DESC"
}
]
}
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "ozon-shop-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"price\":1947,\"rating\":4.7,\"monthlySalesUnits\":160,\"weight\":530,\"reviewRating\":4.7,\"sales\":160,\"returnCancellationRate\":24.7,\"imageUrl\":\"https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg\",\"currency\":\"₽\",\"fulfillment\":[\"FBO\"]},{\"price\":1535,\"rating\":4.8,\"monthlySalesUnits\":137,\"weight\":375,\"reviewRating\":4.8,\"sales\":137,\"returnCancellationRate\":18.7,\"imageUrl\":\"https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg\",\"currency\":\"₽\",\"fulfillment\":[\"FBO\"]}],\"products\":[{\"price\":1947,\"rating\":4.7,\"monthlySalesUnits\":160,\"weight\":530,\"reviewRating\":4.7,\"sales\":160,\"returnCancellationRate\":24.7,\"imageUrl\":\"https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg\",\"currency\":\"₽\",\"fulfillment\":[\"FBO\"]},{\"price\":1535,\"rating\":4.8,\"monthlySalesUnits\":137,\"weight\":375,\"reviewRating\":4.8,\"sales\":137,\"returnCancellationRate\":18.7,\"imageUrl\":\"https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg\",\"currency\":\"₽\",\"fulfillment\":[\"FBO\"]}],\"rating\":4.8,\"total\":5,\"hasNextPage\":false,\"dailySales\":13,\"totalSales\":379,\"productCount\":5,\"totalRevenue\":533893,\"fulfillment\":{\"FBO\":5}}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"price": 1947,
"rating": 4.7,
"monthlySalesUnits": 160,
"weight": 530,
"reviewRating": 4.7,
"sales": 160,
"returnCancellationRate": 24.7,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
]
},
{
"price": 1535,
"rating": 4.8,
"monthlySalesUnits": 137,
"weight": 375,
"reviewRating": 4.8,
"sales": 137,
"returnCancellationRate": 18.7,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
]
}
],
"products": [
{
"price": 1947,
"rating": 4.7,
"monthlySalesUnits": 160,
"weight": 530,
"reviewRating": 4.7,
"sales": 160,
"returnCancellationRate": 24.7,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
]
},
{
"price": 1535,
"rating": 4.8,
"monthlySalesUnits": 137,
"weight": 375,
"reviewRating": 4.8,
"sales": 137,
"returnCancellationRate": 18.7,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg",
"currency": "₽",
"fulfillment": [
"FBO"
]
}
],
"rating": 4.8,
"total": 5,
"hasNextPage": false,
"dailySales": 13,
"totalSales": 379,
"productCount": 5,
"totalRevenue": 533893,
"fulfillment": {
"FBO": 5
}
}
},
"isError": false
}
}