Skip to main content
Glama

Nexscope Ecommerce Data MCP

Ozon Product Report Search

nexscope_ozon_product_report_search

Nexscope Ozon product report search: filters Ozon products by multi-dimensional metrics including sales, revenue, sales/revenue growth rate, cart conversion rate, order conversion rate, price, rating, review count, QA count, variant count, page views, gross margin, return/cancellation rate, ad spend share, weight/volume, listing time, brand, seller, fulfillment method, and labels. Returns each product's SKU, title, price (RUB), sales, revenue, lost revenue, conversion rate, rating, reviews, brand, seller, fulfillment method, listing days/months, and complete product report fields. Use for Ozon product selection, competitor product analysis, best-seller mining, price/conversion band filtering. Trigger when the user mentions Ozon product report, Ozon product selection, Ozon product filtering, Ozon product analysis, Ozon best-selling products, Ozon competitor product analysis, Ozon product report, Ozon product screener, filter Ozon products by sales, Ozon best-seller mining, Nexscope Ozon product report. Also trigger when the intent is to filter Ozon products by multiple metrics and view product-level reports, even without explicitly mentioning Nexscope.

Input Schema

NameRequiredDescriptionDefault
drrNoAdvertising cost-share range: {min, max}; either bound may be omitted
tagNoTag word
uIdNoUser ID
pageYesNonempty pagination and sorting object: {page, pageSize, orders[]}. Omitted nested defaults are not inserted. Ranges accept optional finite bounds and require min <= max; numeric strings and optional null remain backend compatibility extensions.
skusNoSKU array (max 10), for precise lookup of specified products
brandNoBrand filter: {brandName: array<string>, type: integer}; type takes 0 include brand, 1 exclude brand, 2 unbranded
priceNoPrice range in RUB: {min, max}; either bound may be omitted
labelsNoLabel array, fixed options: 0 new product, 1 genuine product, 2 best seller
volumeNoVolume range in liters: {min, max}; either bound may be omitted. The supplier does not specify whether this measures the item or parcel.
weightNoWeight range in grams: {min, max}; either bound may be omitted. The supplier does not specify whether packaging is included.
keywordsNoKeyword array, filters by product title
memberIdNoMember ID (a unique member identifier; data is attributed to memberId)
variantsNoVariant-count range: {min, max}; either bound may be omitted
page.pageNoPage number, starting from 1, default 1
searchDateNoQuery date yyyy-MM-dd. Omit for a rolling last-30-days period; provide a date to query the preceding complete historical month (2026-04-01 selects March 2026), not month-to-date.
sellerNameNoSeller name array
categoryIdsNoCategory ID array (Nexscope category IDs, not category names)
fulfillmentNoFulfillment method array, fixed options: OZON, FBO, FBS, RFBS, FBP
grossMarginNoGross-margin range: {min, max}; either bound may be omitted
page.ordersNoSort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending). field is a metric field in the response (e.g., sales, revenue, price, reviewRating, reviewCount, salesRate)
reviewCountNoReview-count range: {min, max}; either bound may be omitted
creationDateNoListing time filter (months), fixed options: 1 last 30 days, 3 last 90 days, 6 last 180 days, 12 last year, 24 last two years; no filtering if omitted
monthlySalesNoMonthly sales range: {min, max}; either bound may be omitted
reviewRatingNoRating range from 0 to 5: {min, max}; either bound may be omitted
convToCartPdpNoCart conversion-rate range: {min, max}; either bound may be omitted
page.pageSizeNoItems per page, default 20
monthlyRevenueNoMonthly revenue range in RUB: {min, max}; either bound may be omitted
variationsMergeNoWhether to merge variants: 0 do not merge, 1 merge
monthlySalesRateNoSales growth-rate range: {min, max}; either bound may be omitted
questionsAndAnswersNoQuestion-and-answer count range: {min, max}; either bound may be omitted
returnCancellationRateNoReturn and cancellation-rate range: {min, max}; either bound may be omitted

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Because there is no output schema, the description earns credit for naming the returned fields (SKU, title, price in RUB, sales, revenue, lost revenue, conversion rate, rating, reviews, brand, seller, fulfillment, listing days/months). It discloses nothing about result caps, pagination limits, data freshness, or quota, and it does not address the readOnlyHint=false annotation, which is unusual for a pure filter-and-return operation and could make an agent worry about side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and return values are front-loaded in the first two sentences, which is good. But the trailing trigger section is a long, repetitive keyword dump that literally lists "Ozon product report" twice, padding length without adding routing information an agent can act on.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 31-parameter filter tool with nested range objects and no output schema, the description covers purpose, filterable dimensions, and the shape of the returned product report, which is enough to invoke it correctly. Gaps remain around pagination limits, maximum result depth, and date-window behavior (deferred entirely to the schema's searchDate note).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% across all 31 properties, so each filter's syntax, ranges, and enums are already documented in the schema. The description adds only a conceptual inventory of the filterable dimensions (growth rate, cart conversion, ad spend share, weight/volume, listing time) without explaining format, units, or interaction between filters — the baseline 3 for a fully documented schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence gives a specific verb (filters) on a specific resource (Ozon products) and enumerates the metric dimensions and returned fields, so an agent knows exactly what the tool produces. It never distinguishes itself from close siblings such as nexscope_ozon_product_search, nexscope_ozon_product_detail_search, or nexscope_data_sr_ozon_product_report_search, so sibling routing still requires guesswork.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Use cases are stated explicitly (Ozon product selection, competitor analysis, best-seller mining, price/conversion band filtering) and the trigger list pins down the intents that should select this tool, including the "even without explicitly mentioning Nexscope" catch-all. What is missing is the negative case: no guidance on when to pick nexscope_ozon_product_search or the detail tools instead.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources