Ozon Intelligence MP

Ozon Category Products

List products in an Ozon category with sales, revenue, price, rating, stock, turnover, and lost-revenue metrics. Call it via REST API or MCP.

MCP tool name

nexscope_ozon_category_products

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "ozon-category-products-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_category_products",
    "arguments": {
      "categoryPath": "Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов",
      "currencyRate": 1,
      "endDate": "2026-07-31",
      "includeFbs": false,
      "page": 1,
      "pageSize": 100,
      "startDate": "2026-07-01"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress 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
`categoryPath`	`string`	required	Full Ozon Russian category path, levels separated by /, e.g., Одежда/Женская одежда/Футболки и топы женские Example: Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов
`startDate`	`string`	optional	Statistics start date YYYY-MM-DD; latest is yesterday Example: 2026-01-01
`endDate`	`string`	optional	Statistics end date YYYY-MM-DD; latest is yesterday Example: 2026-01-01
`page`	`integer`	optional	Page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Rows per page 1-100, default 100 Example: 100
`sortField`	`string`	optional	Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating Example: {}
`sortDirection`	`string`	optional	asc / desc Example: {}
`currency`	`string`	optional	Currency code, default RUB, e.g., USD Example: RUB
`currencyRate`	`integer`	optional	Custom exchange rate (for non-default currency) Example: 1
`includeFbs`	`boolean`	optional	Whether to include FBS data Example: false
`filters`	`array`	optional	Numeric conditions combined with AND Example: []
`filters[].field`	`string`	optional	Snake-case numeric column name, such as sales, final_price, rating, comments, balance, revenue, days_in_stock, turnover_days, lost_profit or category_position Example: sales
`filters[].op`	`string`	optional	GTE, LTE, GT, LT, EQ, NOT_EQ or BETWEEN Example: GTE
`filters[].value`	`number`	optional	Primary value; lower bound for BETWEEN Example: 1
`filters[].value2`	`number`	optional	Required upper bound for BETWEEN Example: 2

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`string`	optional	Return code, `"200"` successful Example: {}
`msg`	`string`	optional	Message; success is `ok` Example: {}
`total`	`integer`	optional	The total number of hits in the category Example: {}
`products`	`array`	optional	Product list Example: {}
`columns`	`array`	optional	Render column definition Example: {}
`costTime`	`integer`	optional	Interface time (milliseconds) Example: {}
`costToken`	`integer`	optional	Amount of Token consumed Example: {}
`type`	`string`	optional	response type Example: {}
`productId`	`integer`	optional	SKU ID Example: {}
`title`	`string`	optional	Product name (Russian) Example: {}
`brand`	`string`	optional	brand Example: {}
`brandId`	`integer`	optional	Brand ID Example: {}
`sellerName`	`string`	optional	Seller name Example: {}
`sellerId`	`integer`	optional	Seller ID Example: {}
`category`	`string`	optional	Category path (Russian, `/` separated) Example: {}
`nicheName`	`string`	optional	Track path (Russian) Example: {}
`nicheId`	`integer`	optional	Track ID Example: {}
`country`	`string`	optional	Country of sale, Ozon Hengwei `RU` Example: {}
`firstDate`	`string`	optional	Release date (`yyyy-MM-dd`) Example: {}
`imageUrl`	`string`	optional	Main image URL Example: {}
`productPageUrl`	`string`	optional	Product page URL Example: {}
`price`	`number`	optional	Current selling price Example: {}
`oldPrice`	`number`	optional	Original price before discount Example: {}
`ozonCardPrice`	`number`	optional	Ozon Card Price Example: {}
`currency`	`string`	optional	Currency symbol (`₽` / `$` / `€`) Example: {}
`rating`	`number`	optional	Rating, 0-5 Example: {}
`reviewCount`	`integer`	optional	Number of comments Example: {}
`balance`	`integer`	optional	Current inventory (pieces) Example: {}
`balanceFbs`	`integer`	optional	FBS inventory (number of items shipped by the seller) Example: {}
`frozenStocks`	`integer`	optional	slow-moving inventory Example: {}
`warehousesCount`	`integer`	optional	Number of FBO positions Example: {}
`isFbs`	`boolean`	optional	Whether to ship by FBS Example: {}
`salesPerDay`	`number`	optional	Average daily sales volume (pieces/day) Example: {}
`monthlySalesUnits`	`integer`	optional	Sales volume during the statistical period (pieces) Example: {}
`monthlySalesRevenue`	`number`	optional	Sales during the statistical period Example: {}
`lostProfit`	`number`	optional	Lost sales (caused by stockouts, etc.) Example: {}
`daysInSite`	`integer`	optional	Number of days on sale (statistical period, including out-of-stock days) Example: {}
`daysInStock`	`integer`	optional	days in stock Example: {}
`turnoverDays`	`number`	optional	Turnaround days (the smaller, the faster) Example: {}
`position`	`integer`	optional	Ranking within the current query dimension (this endpoint is category) Example: {}
`categoryPosition`	`integer`	optional	Ranking within category Example: {}
`revenueSharePercent`	`number`	optional	The sales ratio of this SKU in the current query dimension, 0-100 Example: {}

Examples

Example arguments

{
  "categoryPath": "Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов",
  "currencyRate": 1,
  "endDate": "2026-07-31",
  "includeFbs": false,
  "page": 1,
  "pageSize": 100,
  "startDate": "2026-07-01"
}

Example structuredContent

{}