Ozon MCP Server

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.

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).

Важно:

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/