About Ozon MCP Server
Ozon MCP Server is an MCP server published by eduard256 in the Search category: mCP Server for Ozon marketplace - search products, get details, prices and delivery info.
The repository has 76 stars and 14 forks, with the last commit 4 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/eduard256/ozon-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Ozon MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
Ozon MCP Server
MCP-сервер для поиска товаров на Ozon (ozon.ru). Даёт ИИ три инструмента: искать товары, читать карточку и читать отзывы.
Публичного API для покупателей у Ozon нет, а сайт закрыт антиботом Variti. Поэтому сервер держит один headless-браузер Chromium, который проходит проверку один раз, а дальше забирает данные JSON-ом из внутреннего composer-api прямо со страницы. HTML не парсится — данные приходят структурированными.
Инструменты
- ozon_search — поиск товаров. Возвращает название, цену (в рублях, числом), старую цену, скидку, рейтинг, число отзывов, бренд, картинку и чистую ссылку.
- ozon_product_details — карточка товара по SKU, ссылке или slug. Цена (с картой / без карты / старая), наличие, рейтинг, продавец, фото, характеристики, описание.
- ozon_product_reviews — отзывы покупателей: текст, оценка, плюсы, минусы, дата.
Запуск через Docker
Образ опубликован в Docker Hub.
docker run -i --rm --init --shm-size=1g eduard256/ozon-mcp-server:latest
Флаги обязательны: -i — stdin для stdio, --init — корректное завершение Chromium, --shm-size=1g — память для браузера.
Установка в ваш клиент
Инструкция под каждую систему — отдельным файлом:
- Claude Code
- Claude Desktop
- OpenAI Codex CLI
- Cursor
- Windsurf
- VS Code (Copilot)
- Cline
- Continue.dev
- Zed
- JetBrains AI Assistant
- Junie
- Gemini CLI
Как это работает
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).
Важно:
- Нельзя блокировать загрузку картинок, шрифтов и стилей — антибот грузит свои скрипты через них. Заблокируешь — Ozon вернёт 403.
fetchдолжен идти со страницы на домене ozon.ru, а не с пустой — иначе CORS и 403.- Первый запрос платит за прохождение антибота (~12 секунд). Дальше — 0.3–1 секунда.
Локальная разработка
npm install
npx playwright install chromium
node src/index.js # MCP-сервер по stdio
npm run test:parse # офлайн-тесты парсеров на samples/
README fetched from the repository yesterday. The original is authoritative.