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.

MCP tool name

nexscope_ozon_keyword_mining

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ozon-keyword-mining/run

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,
      "uId": "example-id",
      "page": {
        "pageSize": 10,
        "page": 1
      },
      "includeKeywords": [],
      "keyword": "phone case",
      "excludeKeywords": []
    }
  }
}

REST API equivalent

POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/ozon-keyword-mining/run

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

Examples

Example arguments

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

Example structuredContent

{
  "errcode": 1,
  "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
    }
  ]
}