Ozon Product Reviews
ozon_reviewsFetches Ozon product review texts, scores, helpfulness votes, and star distribution, paging through results and deduplicating by UUID. Use it to inspect customer feedback and rating breakdowns.
Instructions
Fetch Ozon product review texts + star distribution via composer-api.bx.
Tier-1 (curl_cffi) tried first, Tier-2 (Chrome CDP) fallback — same path as ozon_card. Returns review texts (comment/positive/negative), per-review score, helpfulness votes, date, plus the overall star distribution and total count.
Pages are walked automatically (30/page) until limit texts are collected
or pages run out, deduplicating by review uuid. Hard cap of 10 pages.
Reviews are pooled per card family, not per product
Ozon shows one shared pool for every variant of a card, and those variants
are frequently different products — different wattage, different brand. So
rating_score and distribution describe the POOL, not the SKU asked for.
Each review carries item_id, the SKU it is really about; own_reviews
counts the returned reviews whose item_id matches requested_item_id, and
pool_variants names every SKU in the pool. Filter by item_id before
drawing any conclusion about a product, and say so when own_reviews is 0 —
a headline 4.8 can be borrowed entirely from neighbours.
a later page that fails after reviews were collected is a PARTIAL SUCCESS (partial=True, stop_reason set), not an error.
Full field list and error codes: guide://ozon/ozon_reviews.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sku_or_path": "<sku_or_path>"
},
"name": "ozon_reviews"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Review ordering. Aliases: "recent"/"default" -> Ozon's new-and-helpful order (not strict chronology), "best"/"highest" -> highest rated first, "worst"/"lowest"/"complaints" -> LOWEST rated first. Raw API values usefulness_desc/score_desc/score_asc also accepted. | recent |
| limit | No | Max review texts to return (1..100). Distribution+total always full. | |
| sku_or_path | Yes | SKU integer-as-string, full Ozon URL, or /product/<digits>/ path. Normalized to /product/<digits>/reviews/ (SSRF-allowlisted). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| sort | No | ||
| _meta | No | ||
| status | No | ||
| partial | No | ||
| reviews | No | ||
| returned | No | ||
| tier_used | No | ||
| last_error | No | ||
| own_reviews | No | ||
| stop_reason | No | ||
| distribution | No | ||
| rating_score | No | ||
| pages_fetched | No | ||
| pool_variants | No | ||
| reviews_count | No | ||
| requested_limit | No | ||
| requested_item_id | No |