Данные магазина и управляемые действия

Текущий статус

Подключение магазина

Откройте Кабинет → Ozon, добавьте магазин и сохраните ключи в «Подключениях и доступах». Проверка ключей подтверждает доступ к API. Новый магазин начнёт отдавать данные после регистрации сборщика и первого успешного сбора; сейчас этот этап выполняется оператором. Состояние видно в разделе «Данные и источники».

Для Ozon предусмотрен отдельный магазин в вашем профиле X-MP. Seller Client ID и API key нужны для данных магазина; Performance Client ID и Client Secret — для рекламы. Это разные пары ключей.

Ключи сохраняются зашифрованными на сервере. Агент получает отдельный ограниченный ключ X-MP. Перед первым разбором проверяются магазин, права, период и полнота сбора.

Данные и аналитика

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

Прибыль зависит от подтверждённой себестоимости, налога и внешних расходов. Выплаты, финансовые продажи и доставленные заказы рассматриваются отдельно. Прогноз должен сопровождаться проверкой ошибки на прошлых днях и ограничениями истории. Через MCP доступны данные, финансовая модель, рекламная аналитика и базовый прогноз. Прогноз возвращает insufficient_data, если не хватает полных дней. Финансовая модель учитывает заданную политику магазина; неизвестные внешние расходы не включаются.

Четыре рабочих блока

Публикация изменений требует доступного исполнителя, прав и подтверждения точного плана. Результат проверяется чтением из Ozon. Автоматические изменения этим этапом не включены.

Операции, память и расписания

ozon.operation.prepare готовит точный план, ozon.operation.get показывает его состояние. Владелец подтверждает конкретные изменения в кабинете. Только после этого ozon.operation.execute может отправить запрос при достаточных правах. ozon.operation.reconcile проверяет результат; при неизвестном результате запрос повторно не отправляется.

Для CPC необходимо явно принять сброс ключевых и минус-слов методом Ozon. Ставка передаётся в единицах API; автоматическое преобразование в рубли не применяется. CPO поддерживает только отдельные активные товары через устаревающий метод с явным подтверждением этого ограничения. Изменение общей ставки всех товаров недоступно.

Задачи и ограничения магазина хранятся в Seller Memory. Через MCP доступны поиск, возобновление, запись, контрольные точки и завершение задач, а также чтение артефактов и контекста. Для каждого действия нужны соответствующие права токена.

ozon.config.compile связывает настройки блока с конкретной версией задачи Memory. ozon.config.get и ozon.schedule.get читают настройки. ozon.schedule.run проверяет подготовку плана, после чего ozon.schedule.set позволяет включить расписание. Расписания по умолчанию выключены и только готовят планы; подтверждение записи остаётся за владельцем. ozon.emergency_stop останавливает автоматизацию магазина.

Перед работой вызовите ozon.connectors.status: ответ показывает свежесть источников, проверку ключей и оставшиеся ограничения. Мониторинг пока только запланирован.

Установка MCP и навыка

Пакет предназначен для Linux, macOS и Windows через WSL; нужен Python 3.10 или новее. Для работы агента нужен уже установленный Codex. Серверы и Docker на компьютер пользователя не устанавливаются.

Скачать установщик Python · Состав и контрольные суммы выпуска · Подключение существующего магазина WB

Подготовка без токена — доступна сейчас

Выполните команды в каталоге проекта. Они загрузят MCP, скрипты и навык Ozon, но не подключат магазин и не изменят настройки WB.

curl --fail --silent --show-error --proto '=https' https://x-mp.ru/docs/ozon/downloads/install.py -o xmp-ozon-install.py
python3 xmp-ozon-install.py prepare --project-root .

Подключение с персональным токеном

Откройте магазин Ozon → «Доступ для агентов» и для настройки выберите «Чтение и подготовка планов» и создайте токен. Он разрешает сохранять задачи и готовить планы; публикация изменений требует отдельного подтверждения. Для просмотра достаточно «Только чтение данных». Создание токена доступно после подключения сбора. Скопируйте показанные ID магазина и токен. ID магазина X-MP отличается от Seller Client ID.

python3 xmp-ozon-install.py install --project-root . --account-id ВАШ_ID_МАГАЗИНА_XMP

Установщик запросит токен скрытым вводом, проверит магазин и платформу Ozon, сохранит токен в защищённом файле и добавит MCP и навык только в этот проект. Для нескольких магазинов используйте отдельные каталоги. После установки откройте доверенный проект в новой сессии Codex.

Что входит в выпуск

Клиент 0.6.2: общий транспорт X-MP, адаптер Ozon, установщик и восемь навыков — подключение, аналитика, память магазина, репрайсер, реклама, отзывы/вопросы и карточки. Они устанавливаются вместе в выбранный проект. Для проверки подключения доступны agent.me, readiness.get, capabilities.list, xmp.services.list и xmp.connectors.list. Их ответы требуют действующего токена. Для данных доступны ozon.status, ozon.datasets, ozon.schema, ozon.records, ozon.product, ozon.finance, ozon.advertising и ozon.forecast. Черновики: ozon.repricer.plan, ozon.bidder.plan, ozon.communications.plan, ozon.cards.plan. Чтение: ozon.plan.get и ozon.plans.list. Для создания выберите в профиле токен «Чтение и подготовка планов». Данные старше часа отклоняются, непроверенные допущения перечисляются в плане. Черновики не являются разрешением на запись.

Обновление и откат

При переходе с 0.4/0.5 на 0.6 скачайте свежий установщик: прежний не знает расширенный набор навыков. Выполните команды ниже в существующем проекте; токен сохраняется.

curl --fail --silent --show-error --proto '=https' https://x-mp.ru/docs/ozon/downloads/install.py -o xmp-ozon-install.py
python3 xmp-ozon-install.py update --project-root .

Проверка обновления:

python3 .xmp-ozon/current/install.py check --project-root .

Обновление всех файлов опубликованного пакета Ozon — MCP, скриптов и навыка:

python3 .xmp-ozon/current/install.py update --project-root .

Токен, настройки WB и пользовательские файлы сохраняются. Файлы проверяются по SHA-256, затем пакет переключается целиком. После обновления перезапустите MCP-сессию. Фонового обновления нет.

Если новый выпуск вызывает проблему, верните предыдущий:

python3 .xmp-ozon/current/install.py rollback --project-root .

Откат доступен после перехода на другой выпуск. Не редактируйте файлы управляемого пакета: изменённый файл остановит обновление или откат, чтобы не потерять ваши изменения.

Ключи и токены

Seller и Performance ключи хранятся зашифрованными на сервере X-MP. Они не включаются в установщик, публичные файлы и навыки. На компьютере агента хранится только его персональный токен X-MP, в .xmp-ozon/secrets/agent.key с правами 0600. Каталог исключается из Git.

Обновление программ сохраняет токен и не продлевает срок его действия. Для замены получите новый токен в профиле, сохраните его в закрытом файле и выполните:

chmod 600 /путь/к/новому-токену
python3 .xmp-ozon/current/install.py rotate-token --project-root . --key-file /путь/к/новому-токену

Новый токен проверяется перед заменой. Старый токен отзовите отдельно в профиле, затем перезапустите MCP. Значение токена не передавайте в чат и не вставляйте в команду. Ключи Ozon можно добавить, проверить, заменить и отключить в разделе «Подключения и доступы» вашего магазина. Открыть магазины Ozon.

Проверка подключения и помощь

После установки выполните проверку реального подключения. Она читает один товар, память и настройки; не создаёт задачи и не меняет Ozon.

python3 .xmp-ozon/current/install.py doctor --project-root .

Ожидается status: connected, восемь навыков и успешные проверки. Для настройки нужны can_prepare_plans: true и can_save_memory: true. Полноту и возраст данных агент проверяет отдельно: успешное подключение не означает полный сбор.

Первый запрос агенту: «Проверь мой магазин Ozon, свежесть и полноту данных, покажи один товар и доступные блоки. Затем помоги сохранить мои цели и ограничения в памяти. Пока ничего не меняй на Ozon».

Если подтверждена ошибка, устаревший источник или нужна новая функция, агент читает навык xmp-support, отправляет краткое обращение через support.submit и позже проверяет ответ через support.status. В обращение не включают токены, личные данные покупателей и сырые ответы API.

После настройки попросите агента вызвать agent.me и readiness.get: должны совпасть магазин и платформа Ozon. Доступные возможности смотрите через capabilities.list. Наличие скачанных файлов не означает доступность данных магазина.

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

Структура настроек соответствует официальной документации Codex MCP.

Дальнейшая работа

Владелец задаёт цель и ограничения, агент анализирует подтверждённые данные и готовит план. X-MP выполняет только доступные и разрешённые серверные процессы. Реальный результат оценивается после чтения изменённых данных.