Keyword & Search Demand

Ozon Keyword Mining MCP Tool

Seerfar Ozon keyword mining: mines Ozon (and Wildberries) related keywords around a seed keyword with multi-dimensional filtering by search volume, growth, product count, seller count, competitor count, price, relevancy, title density, cart-add conversion, etc. Each mined keyword carries a full market profile (monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products). Use for Ozon keyword expansion, long-tail keyword mining, and seed keyword opportunity analysis. Also

MCP tool name

nexscope_ozon_keyword_mining

Legacy MCP endpoint

/api/skill-api/v1/mcp

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

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

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "ozon-keyword-mining-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_keyword_mining",
    "arguments": {
      "matchType": 1,
      "excludeKeywords": [],
      "keyword": "phone case",
      "includeKeywords": [],
      "page": {
        "page": 1,
        "pageSize": 10
      },
      "uId": "example-id"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/ozon-keyword-mining

Arguments

Name	Type	Required	Meaning
`keyword`	`string`	required	Seed keyword, mining expands around this term (maxLength 1000) Example: phone case
`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 Example: 1
`page.orders`	`array`	optional	Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending) Example: []
`matchType`	`integer`	optional	Keyword match mode: 0 exact, 1 fuzzy Example: 1
`includeKeywords`	`array`	optional	Include keyword array (max 1000), used to further narrow down / specify required words on top of the seed term Example: []
`excludeKeywords`	`array`	optional	Exclude keyword array (max 1000), used to remove irrelevant terms Example: []
`wordCount`	`string`	optional	Keyword word count range Example: {}
`searchVolume`	`string`	optional	Search volume range Example: {}
`searchChange30`	`string`	optional	30-day search change range Example: {}
`productViews`	`string`	optional	Product views range Example: {}
`products`	`string`	optional	Product count range Example: {}
`sellers`	`string`	optional	Seller count range Example: {}
`price`	`string`	optional	Price range Example: {}
`marketSpace`	`string`	optional	Market space range Example: {}
`conversionSharing`	`string`	optional	Conversion concentration range Example: {}
`relevancy`	`string`	optional	Relevance range (degree of relevance to the seed keyword) Example: {}
`uniqQueriesWCa`	`string`	optional	Add-to-cart count range Example: {}
`ca`	`string`	optional	Add-to-cart conversion rate range Example: {}
`titleDensity`	`string`	optional	Title density range Example: {}
`adRivalCount`	`string`	optional	Ad competitor count range Example: {}
`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

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.total`	`integer`	optional	Total record count Example: 1
`data.data`	`array`	optional	Keyword mining data (see details below) Example: []
`data.columns`	`array`	optional	Column definitions, elements contain {field, title, cellType, sortable, filterable} Example: []
`data.costTime`	`integer`	optional	API latency (milliseconds) Example: 1
`data.costToken`	`integer`	optional	Tokens consumed Example: 1
`data.type`	`string`	optional	Response display type, e.g., tableListWorkbenches Example: null
`data.data[].query`	`string`	optional	Keyword (original Russian) Example: phone case
`data.data[].queryCn`	`string`	optional	Keyword Chinese translation Example: phone case
`data.data[].platform`	`integer`	optional	Platform: 0 Ozon, 1 Wildberries Example: 1
`data.data[].searchVolume`	`integer`	optional	Monthly search volume Example: 1
`data.data[].count30GrowthRate`	`number`	optional	Monthly search growth (%, can be negative) Example: 1
`data.data[].productCount`	`integer`	optional	Product count (may be missing in some rows) Example: 1
`data.data[].competingProducts`	`integer`	optional	Competing product count Example: 1
`data.data[].sellers`	`integer`	optional	Seller count Example: 1
`data.data[].avgPrice`	`number`	optional	Average price Example: 1
`data.data[].itemsViews`	`number`	optional	Product visibility Example: 1
`data.data[].viewSharing`	`number`	optional	View concentration (%) Example: 1
`data.data[].conversionSharing`	`number`	optional	Conversion concentration (%) Example: 1
`data.data[].marketSpace`	`number`	optional	Market space Example: 1
`data.data[].returnCancellationRate`	`number`	optional	Return/cancellation rate (%) Example: 1
`data.data[].uniqQueriesWCa`	`integer`	optional	Add-to-cart count Example: 1
`data.data[].ca`	`number`	optional	Add-to-cart conversion rate (%) Example: 1
`data.data[].relevancy`	`number`	optional	Relevance (degree of relevance to the seed keyword) Example: 1
`data.data[].titleDensity`	`number`	optional	Title density Example: 1
`data.data[].wordCount`	`integer`	optional	Word count Example: 1
`data.data[].categories`	`array`	optional	Category ID array Example: []
`data.data[].categoryInfos`	`array`	optional	Category information (see below) Example: []
`data.data[].products`	`array`	optional	Top product data (see below) Example: []
`data.data[].id`	`string`	optional	Record ID Example: example-id
`data.products[].ozonId`	`integer`	optional	Ozon product ID Example: 1
`data.products[].sku`	`integer`	optional	SKU ID Example: 1
`data.products[].title`	`string`	optional	Product title (Russian) Example: null
`data.products[].imageUrl`	`string`	optional	Main image URL Example: https://example.com/image.jpg
`data.products[].advert`	`integer`	optional	Ad indicator (0/1) Example: 1
`data.categoryinfos[].titleCn`	`string`	optional	Category Chinese name Example: null
`data.categoryinfos[].titleEn`	`string`	optional	Category English name Example: null
`data.categoryinfos[].titleRu`	`string`	optional	Category Russian name Example: null
`data.categoryinfos[].cnTitlePath`	`string`	optional	Chinese category path Example: null
`data.categoryinfos[].enTitlePath`	`string`	optional	English category path Example: null
`data.categoryinfos[].titlePath`	`string`	optional	Russian category path Example: null
`data.categoryinfos[].id`	`string`	optional	Category ID Example: example-id
`data.categoryinfos[].crossBorderSellable`	`boolean`	optional	Whether cross-border sales are allowed Example: false
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceType`	`string`	optional	Provider-specific source platform type. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. Example: null
`data.page`	`integer`	optional	Current page returned by the upstream provider. Example: null
`data.pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: null
`data.pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: null
`data.totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: null
`data.dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: null

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "matchType": 1,
  "excludeKeywords": [],
  "keyword": "phone case",
  "includeKeywords": [],
  "page": {
    "page": 1,
    "pageSize": 10
  },
  "uId": "example-id"
}

Example structuredContent

{
  "data": {
    "total": 1,
    "data": [
      {
        "query": "phone case",
        "queryCn": "phone case",
        "platform": 1,
        "searchVolume": 1,
        "count30GrowthRate": 1,
        "productCount": 1,
        "competingProducts": 1,
        "sellers": 1,
        "avgPrice": 1,
        "itemsViews": 1,
        "viewSharing": 1,
        "conversionSharing": 1,
        "marketSpace": 1,
        "returnCancellationRate": 1,
        "uniqQueriesWCa": 1,
        "ca": 1,
        "relevancy": 1,
        "titleDensity": 1,
        "wordCount": 1,
        "categories": [],
        "categoryInfos": [],
        "products": [],
        "id": "example-id"
      }
    ],
    "columns": [],
    "costTime": 1,
    "costToken": 1,
    "products": [
      {
        "ozonId": 1,
        "sku": 1,
        "imageUrl": "https://example.com/image.jpg",
        "advert": 1
      }
    ],
    "categoryinfos": [
      {
        "id": "example-id",
        "crossBorderSellable": false
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}