ozon-mcp-server
MCP Server for Ozon marketplace - search products, get details, prices and delivery info
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/eduard256/shopper-mcp with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/eduard256/shopper-mcp'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/eduard256--ozon-mcp-server)HTML
<a href="/listings/eduard256--ozon-mcp-server"><img src="/api/listings/eduard256--ozon-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 68 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <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/
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.