Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eduard256--ozon-mcp-server/badge.svg)](/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

i

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)

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/eduard256/ozon-mcp-server/assets/img/ozon-mcp-logo.webp" alt="OZON MCP" width="420">
  3. </p>
  4. <p align="center">
  5. <img src="https://raw.githubusercontent.com/eduard256/ozon-mcp-server/assets/img/ozon-card.webp" alt="Ozon MCP — search, details, reviews" width="100%">
  6. </p>
  7. # Ozon MCP Server
  8. MCP-сервер для поиска товаров на Ozon (ozon.ru). Даёт ИИ три инструмента: искать товары, читать карточку и читать отзывы.
  9. Публичного API для покупателей у Ozon нет, а сайт закрыт антиботом Variti. Поэтому сервер держит один headless-браузер Chromium, который проходит проверку один раз, а дальше забирает данные JSON-ом из внутреннего `composer-api` прямо со страницы. HTML не парсится — данные приходят структурированными.
  10. ## Инструменты
  11. 1. **ozon_search** — поиск товаров. Возвращает название, цену (в рублях, числом), старую цену, скидку, рейтинг, число отзывов, бренд, картинку и чистую ссылку.
  12. 2. **ozon_product_details** — карточка товара по SKU, ссылке или slug. Цена (с картой / без карты / старая), наличие, рейтинг, продавец, фото, характеристики, описание.
  13. 3. **ozon_product_reviews** — отзывы покупателей: текст, оценка, плюсы, минусы, дата.
  14. ## Запуск через Docker
  15. Образ опубликован в Docker Hub.
  16. ```bash
  17. docker run -i --rm --init --shm-size=1g eduard256/ozon-mcp-server:latest
  18. ```
  19. Флаги обязательны: `-i` — stdin для stdio, `--init` — корректное завершение Chromium, `--shm-size=1g` — память для браузера.
  20. ## Установка в ваш клиент
  21. Инструкция под каждую систему — отдельным файлом:
  22. - [Claude Code](docs/CLAUDECODE-install.md)
  23. - [Claude Desktop](docs/CLAUDE-install.md)
  24. - [OpenAI Codex CLI](docs/CODEX-install.md)
  25. - [Cursor](docs/CURSOR-install.md)
  26. - [Windsurf](docs/WINDSURF-install.md)
  27. - [VS Code (Copilot)](docs/VSCODE-install.md)
  28. - [Cline](docs/CLINE-install.md)
  29. - [Continue.dev](docs/CONTINUE-install.md)
  30. - [Zed](docs/ZED-install.md)
  31. - [JetBrains AI Assistant](docs/JETBRAINS-install.md)
  32. - [Junie](docs/JUNIE-install.md)
  33. - [Gemini CLI](docs/GEMINI-install.md)
  34. ## Как это работает
  35. - `src/browser.js` — один Chromium. Проходит антибот на главной странице и держит её открытой; все `fetch` идут с неё. При HTTP 403/307 (сессия протухла) или падении браузера перезапускается сам. Через 10 минут простоя браузер закрывается, чтобы освободить память.
  36. - `src/parse.js` — чистые парсеры JSON из `composer-api` (`widgetStates`). Без сети.
  37. - `src/ozon.js` — строит пути API, забирает данные, парсит.
  38. - `src/index.js` — MCP-сервер по stdio. Логи идут только в stderr (stdout занят протоколом JSON-RPC).
  39. **Важно:**
  40. 1. Нельзя блокировать загрузку картинок, шрифтов и стилей — антибот грузит свои скрипты через них. Заблокируешь — Ozon вернёт 403.
  41. 2. `fetch` должен идти со страницы на домене ozon.ru, а не с пустой — иначе CORS и 403.
  42. 3. Первый запрос платит за прохождение антибота (~12 секунд). Дальше — 0.3–1 секунда.
  43. ## Локальная разработка
  44. ```bash
  45. npm install
  46. npx playwright install chromium
  47. node src/index.js # MCP-сервер по stdio
  48. npm run test:parse # офлайн-тесты парсеров на samples/
  49. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.