Skip to main content
Glama

Ozon MCP Server

MCP-сервер для поиска товаров на Ozon (ozon.ru). Даёт ИИ три инструмента: искать товары, читать карточку и читать отзывы.

Публичного API для покупателей у Ozon нет, а сайт закрыт антиботом Variti. Поэтому сервер держит один headless-браузер Chromium, который проходит проверку один раз, а дальше забирает данные JSON-ом из внутреннего composer-api прямо со страницы. HTML не парсится — данные приходят структурированными.

Инструменты

  1. ozon_search — поиск товаров. Возвращает название, цену (в рублях, числом), старую цену, скидку, рейтинг, число отзывов, бренд, картинку и чистую ссылку.

  2. ozon_product_details — карточка товара по SKU, ссылке или slug. Цена (с картой / без карты / старая), наличие, рейтинг, продавец, фото, характеристики, описание.

  3. ozon_product_reviews — отзывы покупателей: текст, оценка, плюсы, минусы, дата.

Related MCP server: mcp-ozon-seller

Запуск через Docker

Образ опубликован в Docker Hub.

docker run -i --rm --init --shm-size=1g eduard256/ozon-mcp-server:latest

Флаги обязательны: -i — stdin для stdio, --init — корректное завершение Chromium, --shm-size=1g — память для браузера.

Установка в ваш клиент

Инструкция под каждую систему — отдельным файлом:

Как это работает

  • src/browser.js — один Chromium. Проходит антибот на главной странице и держит её открытой; все fetch идут с неё. При HTTP 403/307 (сессия протухла) или падении браузера перезапускается сам. Через 10 минут простоя браузер закрывается, чтобы освободить память.

  • src/parse.js — чистые парсеры JSON из composer-api (widgetStates). Без сети.

  • src/ozon.js — строит пути API, забирает данные, парсит.

  • src/index.js — MCP-сервер по stdio. Логи идут только в stderr (stdout занят протоколом JSON-RPC).

Важно:

  1. Нельзя блокировать загрузку картинок, шрифтов и стилей — антибот грузит свои скрипты через них. Заблокируешь — Ozon вернёт 403.

  2. fetch должен идти со страницы на домене ozon.ru, а не с пустой — иначе CORS и 403.

  3. Первый запрос платит за прохождение антибота (~12 секунд). Дальше — 0.3–1 секунда.

Локальная разработка

npm install
npx playwright install chromium
node src/index.js          # MCP-сервер по stdio
npm run test:parse         # офлайн-тесты парсеров на samples/

Available Tools

3 tools
ozon_product_detailsGet Ozon product detailsA
Read-onlyIdempotent

Get full details for one Ozon product: name, price (card/regular/old), availability, product rating, seller (name + rating), images, key characteristics, and the product description (text and/or banner image URLs). Accepts an SKU, a full product URL, or a slug.

Inputs: product (required).

ozon_product_reviewsGet Ozon product reviewsA
Read-onlyIdempotent

Read real customer reviews for an Ozon product: author, score (1–5), comment, pros, cons, date, usefulness, whether the item was purchased, and whether photos are attached. Accepts an SKU, a full product URL, or a slug.

Inputs: product (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct task: search, product details, and reviews. No overlap in purpose, so an agent can clearly differentiate them.

    Naming Consistency4/5

    All tools share the 'ozon_' prefix and use clear resource-action naming, but 'search' is a verb while the other two are noun phrases, introducing a slight inconsistency.

    Tool Count4/5

    Three tools is appropriate for a focused product information server; it's slightly thin but covers the core functionality without feeling insufficient.

    Completeness4/5

    The set covers searching, detailed product info, and reviews—core read operations. It lacks tools for categories or recommendations, but for the stated scope it is reasonably complete.

    Maintenance

    ActivityMaintained
    ResponsivenessMixed handling

    Related MCP Connectors

    Related MCP Servers