Сравнивайте товары на 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_search | Ищет товары с сортировкой, ценовыми фильтрами и лимитом выдачи | | ozon_product | Читает цену, наличие, продавца, рейтинг, изображения и характеристики | | ozon_reviews | Читает свежие отзывы, плюсы, минусы и оценки | | ozon_health | Проверяет готовность локальной сессии | | ozon_setup_session | Создаёт или обновляет сессию в отдельном окне браузера |

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

1. setup создаёт анонимную браузерную сессию Ozon и сохраняет её вне репозитория.
2. MCP-инструменты повторно используют сессию в headless Chrome.
3. Запросы выполняются последовательно с ограничением частоты.
4. Если сессия истекла, сервер просит явно запустить 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.

Лицензия

MIT © 2026 Maxim Zaytcev и контрибьюторы.