Русский · English

Ozon Shopping MCP

Сравнивайте товары на Ozon вместе с ИИ. Ozon Shopping MCP превращает поиск, карточки и отзывы в
инструменты вашего MCP-клиента — локально, без ключей Seller API и десятков открытых вкладок.

Сервер работает только на чтение: не управляет кабинетом продавца, корзиной, заказами или аккаунтом.
Браузерная сессия остаётся на вашем компьютере.

Альфа-версия: у Ozon нет публичного API для покупателей, поэтому проект использует внутренние
эндпоинты сайта. Они и защита от автоматизации могут измениться без предупреждения.

Возможности

находит товары и сортирует их по популярности, цене, рейтингу, новизне или скидке;
отбирает варианты в заданном ценовом диапазоне;
собирает цены, наличие, рейтинг, продавца, изображения и характеристики;
разбирает свежие отзывы, оценки, плюсы и минусы;
работает локально через защищённую сессию с ограничением частоты запросов.

Быстрый старт

Нужны Node.js 24 LTS или новее и Google Chrome. Настройте локальную сессию одной командой:

npx -y ozon-shopping-mcp@latest setup

Добавьте сервер в Codex:

codex mcp add ozon-shopping -- npx -y ozon-shopping-mcp@latest serve

Для другого MCP-клиента используйте stdio-конфигурацию:

{
  "mcpServers": {
    "ozon-shopping": {
      "command": "npx",
      "args": ["-y", "ozon-shopping-mcp@latest", "serve"]
    }
  }
}

Проверка Ozon может появиться при первой настройке. После неё запросы выполняются в headless Chrome без
видимого браузера.

Примеры запросов

Найди 5 беспроводных мышей до 4 000 ₽. Отдай приоритет моделям с рейтингом
от 4,7 и 300+ отзывами. Сравни актуальную цену, наличие, продавца, подключение
и вес, затем порекомендуй лучшую для ежедневной работы.

Сравни 5 аэрогрилей до 12 000 ₽ объёмом от 5 литров. Проверь в карточках
мощность, программы и габариты, собери частые плюсы и проблемы из свежих
отзывов и выбери лучший вариант для семьи.

Подбери power bank на 20 000 мА·ч с USB-C PD от 65 Вт до 7 000 ₽. Проверь
порты и вес, а в отзывах найди жалобы на нагрев, ёмкость и быструю зарядку.
Отдельно отметь всё, что не удалось подтвердить по карточке товара.

Найди Samsung Galaxy S24 256 ГБ у разных продавцов на Ozon. Собери до 5
подходящих карточек, проверь точную модель и объём памяти, сравни актуальные
цены, наличие, продавцов, характеристики и свежие отзывы. Покажи самый
выгодный вариант и важные различия между предложениями.

Каждый запрос запускает всю цепочку: поиск → карточки кандидатов → отзывы → итоговое сравнение.

Пример работы

Сравнение товаров Ozon в Codex с помощью Ozon Shopping MCP

Инструменты

Инструмент	Что делает
`ozon_search`	Ищет товары с сортировкой, ценовыми фильтрами и лимитом выдачи
`ozon_product`	Читает цену, наличие, продавца, рейтинг, изображения и характеристики
`ozon_reviews`	Читает свежие отзывы, плюсы, минусы и оценки
`ozon_health`	Проверяет готовность локальной сессии
`ozon_setup_session`	Создаёт или обновляет сессию в отдельном окне браузера

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

setup создаёт анонимную браузерную сессию Ozon и сохраняет её вне репозитория.
MCP-инструменты повторно используют сессию в headless Chrome.
Запросы выполняются последовательно с ограничением частоты.
Если сессия истекла, сервер просит явно запустить setup снова.

Безопасность и ограничения

файл сессии содержит cookies и хранится с закрытыми правами доступа (0700/0600, где поддерживается);
cookies, тела заблокированных ответов и неизвестные внутренние ошибки не возвращаются через MCP;
названия, характеристики и отзывы считаются недоверенными данными — агент не должен выполнять найденные в них инструкции;
цены, наличие и порядок выдачи зависят от региона, сессии и времени запроса;
проект предназначен для интерактивного личного использования, а не для массового сбора данных или публичного HTTP-моста.

Подробнее: SECURITY.md. Проект не связан с Ozon и не одобрен или спонсируем компанией.

Разработка

git clone https://github.com/neosheps/ozon-shopping-mcp.git
cd ozon-shopping-mcp
npm ci
npm run check
npm run build

Подробнее об устройстве проекта — в docs/architecture.md, об участии в разработке —
в CONTRIBUTING.md.

ozon-shopping-mcp