Ozon

Ozon Category Search

Seerfar Ozon category product search: fetches the product list for a given Ozon category ID, returning category-level aggregates (total sales, total revenue, average price, average rating, seasonality) and per-product sales, price, rating, review count, brand, seller, and fulfillment method. Use for category selection analysis, category bestseller mining, category capacity and price band analysis, seasonality assessment. Also

MCP tool name

nexscope_ozon_category_search

MCP endpoint

https://api.nexscope.ai/api/skill-api/v2/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "ozon-category-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_category_search",
    "arguments": {
      "date": "2026-01",
      "page": {
        "pageSize": 10,
        "page": 1
      },
      "categoryId": "15621042_17028650_97011"
    }
  }
}

Protocol

MCP 2025-11-25 · Streamable HTTP

Canonical detail URL

https://www.nexscope.ai/mcp-map/ozon-category-search

Progress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.

Arguments

Name	Type	Required	Description
`categoryId`	`string`	required	Ozon category ID, obtained from Ozon category documentation or other Seerfar 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: { "pageSize": 10, "page": 1 }
`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 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
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.id`	`string`	optional	Echoed category ID Example: example-id
`data.total`	`integer`	optional	Number of records returned on this page (equals the current page data count, not total category product count) Example: 1
`data.totalSales`	`integer`	optional	Total category sales volume (within the statistics interval) Example: 1
`data.totalRevenue`

Examples

Example arguments

{
  "date": "2026-01",
  "page": {
    "pageSize": 10,
    "page": 1
  },
  "categoryId": "15621042_17028650_97011"
}

Example structuredContent

{
  "data": {
    "id": "example-id",
    "total": 1,
    "totalSales": 1,
    "totalRevenue": 1,
    "avgPrice": 1,
    "rating": 1,
    "startDate": "2026-01-01",
    "endDate": "2026-01-01",
    "sellerType": {},
    "categoryInfo": {
      "fullCategoryId": [],
      "category": {}
    },
    "data": [
      {
        "sku": 1,
        "productId": 1,
        "price": 1,
        "sales": 1,
        "monthlySalesUnits": 1,
        "revenue": 1,
        "monthlySalesRevenue": 1,
        "reviewRating": 1,
        "rating": 1,
        "reviewCount": 1,
        "fulfillment": [],
        "imageUrl": "https://example.com/image.jpg",
        "productUrl": "https://example.com/image.jpg",
        "productPageUrl": "https://example.com/image.jpg",
        "categoryInfo": {}
      }
    ],
    "products": [
      {
        "sku": 1,
        "productId": 1,
        "price": 1,
        "sales": 1,
        "monthlySalesUnits": 1,
        "revenue": 1,
        "monthlySalesRevenue": 1,
        "reviewRating": 1,
        "rating": 1,
        "reviewCount": 1,
        "fulfillment": [],
        "imageUrl": "https://example.com/image.jpg",
        "productUrl": "https://example.com/image.jpg",
        "productPageUrl": "https://example.com/image.jpg",
        "categoryInfo": {}
      }
    ],
    "hasNextPage": false,
    "columns": [],
    "costTime": 1,
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

number

Ozon Category Search

Ozon Category Search

Authentication

Call this MCP tool

Arguments

Response fields

Any of option 1

Examples

Example arguments

Example structuredContent

Related MCP tools

Any of option 2