Ozon Consumer MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OZON_MCP_CONFIG | No | Environment variable for isolating the Ozon MCP configuration. | |
| OZON_MCP_STATE_DIR | No | Environment variable for isolating the Ozon MCP state directory. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Потребительский Ozon через локальный Chrome и внутренний Luna-адаптер. Вход ручной, пароль/код не запрашивайте. Цена означает только подтверждённую цену Ozon Карты; null означает неизвестно. Поиск/карточки/отзывы/вопросы/медиа/заказы возвращают структурированные сущности и покрытие; пагинацию продолжайте до конца, не называйте частичные данные всеми. Обратимые изменения требуют apply=true и поручения владельца. Конечные действия только prepare → прочитать точный preview → явное поручение владельца → action_confirm с полученным токеном/digest/confirmed=true. Токен не является подтверждением владельца. Не повторяйте результат unknown. При разработке запрещены покупки, отправка скидок, возвраты и публикация отзывов.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ozon_auth_openA | Открыть или показать отдельный Chrome для ручного входа в Ozon. Владелец сам вводит телефон и код. Существующая сессия сохраняется; пароль инструменту не нужен. |
| ozon_auth_statusA | Проверить наличие сессии Ozon и доступность страницы. Не возвращает cookies, токены, телефон, имя или ID аккаунта. |
| ozon_auth_saveA | После ручного входа проверить авторизацию и сохранить приватную резервную копию сессии. Основная авторизация хранится в отдельном профиле Chrome. |
| ozon_searchA | Поиск с ценой Ozon Карты, рейтингом товара, числом отзывов/вопросов и сроком доставки. sort: popular/cheaper/expensive/rating/new/relevance. Фильтры: цена, brands, deliveryWithinDays и динамические name/values из ozon_search_filters. Неподтверждённые ограничения не игнорируются. |
| ozon_productA | Полная карточка: купон (coupon: наличие/применение/цена уже со скидкой), название, подтверждённая цена Ozon Карты, рейтинг/отзывы/вопросы, раскрытое описание/характеристики, продавец и доставка. sections позволяет узкий запрос. Для галереи, полных отзывов и вопросов используйте отдельные инструменты. |
| ozon_shopping_listA | Создать или сверить личный лист покупок без обложки: name и productUrls. apply=true выполняет разрешённое сохранение с проверкой каждого SKU и приватности. При неизвестном исходе сначала collections с name. Повторный вызов не дублирует готовый список. |
| ozon_product_variantsB | Наблюдаемые группы вариантов товара: цвет, размер, мощность, комплектация. Возвращает варианты с variantId, URL/SKU и состоянием. |
| ozon_product_variant_selectB | Переключить на вариант из product_variants по variantId. Заново проверяет вариант и конечный SKU. Используйте возвращённый url для карточки и отзывов. |
| ozon_search_filtersB | Показать актуальные фильтры текущей категории и варианты сортировки. Раскрывает цену, бренд, срок доставки и категорийные параметры; исключает финансовые промо. |
| ozon_product_mediaA | Открыть галерею товара и собрать все доступные фотографии/видео в максимальном реально наблюдаемом разрешении. Возвращает mediaId, URL, размеры и полноту. Невидимые оригиналы не выдумывает. |
| ozon_review_mediaA | Открыть галерею конкретного ранее прочитанного отзыва по reviewId из ozon_reviews. Сверяет автора/дату/текст и собирает реальные крупные источники фото/видео. Не подставляет фото другого отзыва. |
| ozon_media_getA | Получить ранее наблюдаемое изображение по mediaId как MCP image для просмотра внешним агентом; для видео возвращает исходный URL. analyze=true дополнительно анализирует изображение Luna по question. |
| ozon_media_importA | Импортировать выбранное владельцем PNG/JPEG/WebP для обложки, отзыва или возврата. Файл должен находиться в ~/.local/share/ozon-mcp/uploads; произвольные локальные файлы не читаются. Возвращает mediaId для явной последующей загрузки. |
| ozon_reviewsA | Отдельные полные отзывы: текст/достоинства/недостатки, звёзды, автор/дата/вариант, фото/видео, ответы и голоса. По умолчанию scope=current: только «Этот вариант». scope=all явно включает всю группу. Если фильтр не подтверждён, отзывы не выдаются. Сортировка useful/new/rating_asc/rating_desc. Продолжайте nextCursor до конца; coverage отражает полноту. |
| ozon_questionsB | Отдельные вопросы и все раскрытые ответы, с автором/датой/признаком продавца. Поддерживает limit/cursor; не отправляет новых вопросов. |
| ozon_ordersB | Активные/завершённые/all заказы: что и когда доставят/доставили, статусы, ссылки на детали и доступность возврата/отзыва. Приватные данные только для запроса владельца. |
| ozon_order_detailA | Прочитать конкретный заказ, доставку, товары и доступные действия. Передайте url ИЛИ orderId из ozon_orders, даже когда карточка обзора не показала ссылку/названия товаров. Заказ не изменяется. |
| ozon_collectionsB | Прочитать списки избранного, вишлисты и подборки, их описания/обложки/видимость/число товаров. |
| ozon_collection_createA | Создать подборку с точным названием, описанием, обложкой coverMediaId, isPublic и начальными productUrls. По умолчанию preview; apply=true выполняет по поручению владельца. Публичность не выбирается автоматически. |
| ozon_favoriteA | Сохранить товар в favorites, wishlist или collection. Для конкретной подборки/вишлиста укажите listName (collectionName — совместимый вариант). Уже сохранённое не удаляет. apply=true — выполнить по поручению; иначе preview. |
| ozon_cartA | Прочитать корзину, количества/выбор, цены Ozon Карты и сроки доставки. Ничего не меняет. |
| ozon_cart_addA | Добавить конкретный товар в корзину с указанным количеством, сохраняя остальные позиции. apply=true — выполнить по поручению; иначе preview. Покупку не оформляет. |
| ozon_checkout_prepareA | Открыть Купить сейчас, проверить точный товар/количество/итог/доставку/ПВЗ/оплату, НЕ нажимая Оформить заказ. maxTotalRub — предельный итог. Предпочтение: Ozon Рассрочка и сохранённый ПВЗ. При полном плане возвращает одноразовый confirmation. |
| ozon_discount_prepareA | Подготовить запрос Хочу скидку, заполнить цену/текст, НЕ отправлять. Вернуть точный preview и confirmation, если форма подтверждена. |
| ozon_return_prepareA | Подготовить возврат конкретного купленного товара/количества, НЕ отправлять. reason — точная реальная причина из формы, comment — пояснение владельца. availableChoices показывает варианты при неполной подготовке. Возвращает условия/план и confirmation при полном подтверждении. |
| ozon_review_prepareA | Подготовить отзыв только по купленному товару: точные stars/text/pros/cons/media владельца. Не выдумывать опыт и НЕ публиковать. Вернуть preview и confirmation. |
| ozon_action_confirmA | ОПАСНОЕ КОНЕЧНОЕ ДЕЙСТВИЕ: оформить покупку, отправить скидку/возврат или опубликовать отзыв. Только по ЯВНОМУ поручению владельца после чтения preview. Передать точный token/digest и confirmed=true. Повторно проверяет факты; одноразовое выполнение. Нельзя использовать для тестов разработки. При unknown НЕ повторять. |
| ozon_action_statusA | Прочитать состояние подготовленного/начатого конечного действия. unknown/attempting требуют сверки факта, а не повторной отправки. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 28 tools
Tools are grouped by clear purpose (auth, search/product, reviews/media, orders, lists, cart/checkout, prepare/confirm actions), and the prepare→confirm→status pattern is explicit. The main fuzziness is in the media quartet (ozon_media_get, ozon_review_media, ozon_product_media, ozon_media_import) and the list trio (ozon_favorite, ozon_collections, ozon_shopping_list), where boundaries are clarified only by long descriptions.
All 28 tools share the ozon_ prefix and snake_case, mostly following a noun_verb or verb_noun scheme (ozon_search, ozon_order_detail, ozon_cart_add, ozon_return_prepare). Minor deviations: ozon_media_get puts the verb last while ozon_product_media has no verb, and ozon_media_get/ozon_media_import use 'media' as the noun prefix instead of the resource-first style seen elsewhere.
28 tools is heavy (above the ~25 threshold) and will strain an agent's tool selection context. However, the surface covers a genuinely broad marketplace domain — auth, search, product, variants, reviews, media, questions, orders, cart, checkout, discounts, returns, collections — so most tools map to a distinct need rather than being redundant.
Read coverage is excellent (search+filters, product, variants, media, reviews+review media, questions, orders, order detail, cart, collections, auth) and the write side has a coherent preview→confirm gate covering purchase, discount, return, review publish, favorites, and collection creation. Notable gaps remain around mutation/cleanup: no cart quantity update or item removal, no collection/list update or delete, no unfavorite, and no order cancellation.