How do I use ozon-customer-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ozon-customer-mcp Найди на Ozon беспроводные наушники, сравни продавцов и покажи отзывы" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ozon-customer-mcp

by Raleose

Overview Schema Related Servers Score Discussions

JavaScript

Local

ozon-customer-mcp

MCP-сервер для маркетплейса Ozon (сторона покупателя): поиск, карточки товаров, отзывы, Q&A, сравнение продавцов, каталоги и город доставки через Model Context Protocol.

Репозиторий: ozon-customer-mcp. Имя MCP-сервера и Docker-образа совпадает.

Работает в Cursor, Claude Desktop, VS Code и других MCP-клиентах.

Зачем

У Ozon нет публичного consumer API. Сайт защищён антиботом — обычный headless Chromium в Docker часто получает капчу.

Этот сервер держит сессию anti-detect браузера Camoufox, один раз проходит JS-челлендж и дальше читает внутренний composer-api как JSON. HTML не парсится.

Related MCP server: marketplace-mcp

Инструменты

Tool	Назначение
`ozon_search`	Поиск (+ foodOnly, pages, seller min*, withDelivery)
`ozon_product_details`	Карточка (+ `nutrition{}`, `imageDataUri`, delivery)
`ozon_products_batch`	Пакет 1–40 карточек (БЖУ / Data URI)
`ozon_product_reviews`	Отзывы (sort helpful/date/product, aboutProduct)
`ozon_product_questions`	Вопросы и ответы на карточке
`ozon_product_offers`	Тот же товар у других продавцов (+ даты доставки, `location`)
`ozon_product_variants`	Варианты (память, цвет, …)
`ozon_product_specs`	Полные характеристики (+ `nutrition{}`)
`ozon_compare_products`	Сравнение 2–8 товаров (матрица + extracted)
`ozon_seller_info`	Профиль продавца
`ozon_seller_catalog`	Каталог магазина
`ozon_category_browse`	Товары в категории (+ filters, dedupe)
`ozon_list_categories`	Живое дерево категорий (title + slug, без хардкода)
`ozon_brand_catalog`	Витрина бренда (+ `filters`)
`ozon_related_products`	«Покупают вместе» / похожие
`ozon_search_filters`	Доступные фильтры поиска
`ozon_get_location`	Текущий город доставки сессии
`ozon_search_cities`	Живой поиск городов (Ozon Maps suggest)
`ozon_set_city`	Сменить город доставки (через выбор ПВЗ)

Доставка и город

По умолчанию анонимная сессия — Москва. Даты в ozon_product_offers относятся к location.city.

Типичный сценарий:

ozon_get_location
ozon_search_cities({ query: "Каз" })   → показать варианты пользователю
ozon_set_city({ city: "Казань" })      → ~20–40 с
ozon_product_offers({ product: sku })  → даты для выбранного региона

ozon_search_cities ходит в живой API Ozon (не хардкод). Список городов всегда актуальный.

Идентификаторы

Товар: SKU, URL https://www.ozon.ru/product/... или slug
Продавец / категория / бренд: slug, numeric id или полный URL
Категория: только реальный slug из ozon_list_categories / ozon_search_filters или ozon.ru — Ozon смотрит на numeric id, угаданный префикс может открыть чужую категорию

ozon_list_categories()                    → топ-отделы
ozon_list_categories({ parent: "…" })     → дети
ozon_list_categories({ query: "…" })      → категории по поисковому запросу
ozon_category_browse({ category: slug })  → товары

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

git clone https://github.com/Raleose/ozon-customer-mcp.git
cd ozon-customer-mcp
docker build -t ozon-customer-mcp:latest .

MCP-конфиг (Docker)

Скопируйте docs/mcp.example.json в конфиг клиента (например ~/.cursor/mcp.json) или используйте .cursor/mcp.json в проекте:

{
  "mcpServers": {
    "ozon-customer": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init", "--stop-timeout=10", "--shm-size=1g",
        "--label", "ozon-customer-mcp=1",
        "ozon-customer-mcp:latest"
      ]
    }
  }
}

После сборки перезагрузите MCP-сервер в клиенте. Должно быть 17 tools.

Подробнее: docs/install.md.

Архитектура

MCP-клиент
    ↓ stdio
  src/index.js              — MCP tools
  src/ozon.js               — пути composer-api
  src/parse.js              — парсеры widgetStates
  src/browser.js            — мост Node ↔ Python
    ↓
  python/browser_service.py — Camoufox + location
  python/locations.py       — парсинг suggest / location
    ↓
  www.ozon.ru composer-api

Локальная разработка

npm install
pip install -r python/requirements.txt
python -m camoufox fetch

node src/index.js                 # MCP по stdio
python test/locations.test.py     # unit-тесты location/suggest
node scripts/smoke-test.js        # live smoke (нужен Camoufox)
node scripts/smoke-location.js    # live: search_cities + set_city

Переменные окружения

Переменная	По умолчанию	Описание
`OZON_HEADLESS`	`true`	Headless Camoufox
`OZON_GEOIP`	`false`	Геолокация браузера по IP (не прокси)
`OZON_CHALLENGE_WAIT_MS`	`15000`	Ожидание антибота
`OZON_EXIT_IDLE_MS`	`600000`	Exit после простоя (Docker `--rm` убирает контейнер)
`OZON_PYTHON`	`python3`	Интерпретатор для browser service
`HTTP_PROXY` / `HTTPS_PROXY`	—	HTTP(S)-прокси при необходимости

Docker-контейнеры

Контейнер живёт, пока открыта MCP-сессия. После отключения клиента или idle-таймаута процесс завершается, --rm удаляет контейнер.

Зависшие:

.\scripts\cleanup-containers.ps1

Troubleshooting

Симптом	Что сделать
Antibot / Captcha	Другой IP или RU-прокси
HTTP 403	Сессия перезапустится сама
Контейнеры не удаляются	Пересоберите образ, проверьте `--stop-timeout=10`
Мало tools в клиенте	Reload MCP / пересоберите `ozon-customer-mcp:latest`
Город не тот	`ozon_search_cities` → `ozon_set_city`
Пустой search	Смотри `hint` / `suggestedCategory` или `ozon_search_filters`

Лицензия

MIT — см. LICENSE.

Install Server

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

hermes-marketplace-tools
E-commerce & Retail Search Web Scraping
vladthecto
F
license
B
quality
C
maintenance
Provides MCP tools for searching and comparing products on Wildberries (and Ozon planned), including product search, detailed card retrieval, and review fetching, normalized for LLM consumption.
Updated a month ago (2026-07-20 18:33 UTC)
3
2
marketplace-mcp
E-commerce & Retail Web Scraping
YegorMy
A
license
D
quality
B
maintenance
Enables product search and price comparison across Ozon and Yandex Market via a read-only MCP server, returning normalized data with source URLs.
Updated a month ago (2026-07-22 17:04 UTC)
6
MIT
mcp-ozon-seller
E-commerce & Retail Finance
woyaxnini
A
license
A
quality
D
maintenance
MCP server for Ozon Seller API that enables AI clients to manage products, prices, stocks, orders, analytics, and finances on Ozon marketplace.
Updated 4 months ago (2026-04-17 12:42 UTC)
26
73
6
Unlicense - libtelnet variant
Kettu Marketplace Intelligence
E-commerce & Retail Web Scraping Browser Automation
neuratechcompany-ops
A
license
Not graded
quality
C
maintenance
Enables querying and comparing prices, availability, ratings, reviews, and seller details from major Russian and Chinese marketplaces (Wildberries, Ozon, Yandex Market, and others) without requiring API keys, via a unified MCP interface.
Updated 7 days ago (2026-08-24 12:44 UTC)
3
MIT

View all related MCP servers

Related MCP Connectors

Canopy API
Amazon product API & MCP server: search, prices, reviews, sellers, deals, and ASIN lookup by Canopy.
kalicart-global
Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.
Shoptera Product Intelligence
Search ~8.5M products from 2,500+ Central European e-shops. Semantic, keyword, GTIN lookup.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Raleose/ozon-customer-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

ozon-customer-mcp

Зачем

Инструменты

Доставка и город

Идентификаторы

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

MCP-конфиг (Docker)

Архитектура

Локальная разработка

Переменные окружения

Docker-контейнеры

Troubleshooting

Лицензия

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

hermes-marketplace-tools

marketplace-mcp

mcp-ozon-seller

Kettu Marketplace Intelligence

Related MCP Connectors

Latest Blog Posts

MCP directory API