Skip to main content
Glama
README.md
<p align="center">
  <img src="https://raw.githubusercontent.com/eduard256/ozon-mcp-server/assets/img/ozon-mcp-logo.webp" alt="OZON MCP" width="420">
</p>

<p align="center">
  <img src="https://raw.githubusercontent.com/eduard256/ozon-mcp-server/assets/img/ozon-card.webp" alt="Ozon MCP — search, details, reviews" width="100%">
</p>

# 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** — отзывы покупателей: текст, оценка, плюсы, минусы, дата.

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

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

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

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

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

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

- [Claude Code](docs/CLAUDECODE-install.md)
- [Claude Desktop](docs/CLAUDE-install.md)
- [OpenAI Codex CLI](docs/CODEX-install.md)
- [Cursor](docs/CURSOR-install.md)
- [Windsurf](docs/WINDSURF-install.md)
- [VS Code (Copilot)](docs/VSCODE-install.md)
- [Cline](docs/CLINE-install.md)
- [Continue.dev](docs/CONTINUE-install.md)
- [Zed](docs/ZED-install.md)
- [JetBrains AI Assistant](docs/JETBRAINS-install.md)
- [Junie](docs/JUNIE-install.md)
- [Gemini CLI](docs/GEMINI-install.md)

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

- `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 секунда.

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

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

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