Skip to main content
Glama
Ozon Consumer MCP

Ozon Consumer MCP

by errogaht

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OZON_MCP_CONFIGNoEnvironment variable for isolating the Ozon MCP configuration.
OZON_MCP_STATE_DIRNoEnvironment 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 28 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count3/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues