MCP для Wildberries

Языковая модель сама по себе не знает ничего про ваш магазин. Есть три способа это исправить, и только третий масштабируется.

Первый — копировать данные в чат руками. Работает один раз, ломается на объёме, устаревает мгновенно.

Второй — писать для каждой модели свою интеграцию. Дорого и живёт ровно до следующего обновления клиента.

Третий — договориться о едином языке между ИИ-клиентами и источниками данных. Это и есть MCP. Источник (у нас — платформа) публикует набор инструментов с описанием: что делает, какие параметры принимает, что возвращает. Клиент (Claude, Cursor и другие) читает этот список и дальше сам решает, какой инструмент вызвать под ваш вопрос. Вам не нужно ни программировать, ни знать названия инструментов — достаточно спросить словами.

Ключевое отличие от простого доступа к API маркетплейса: MCP-сервер платформы отдаёт не сырьё, а уже собранные и сведённые данные — те же цифры, что вы видите в разделах платформы, включая приведённые к общему виду показатели Wildberries и Ozon.

• Сводные показатели продаж за месяц — выручка, к перечислению, заказы, средний чек, остатки, расход рекламы, ДРР плюс дневная динамика заказов и выручки.
• Заказы — список из общего представления Wildberries и Ozon с фильтрами по периоду, площадке, статусу и поиску, с разбивкой по статусам и постраничной выдачей.
• Товарный учёт — четыре представления: сводка по складу, оборачиваемость с прибыльностью по товарам, потребность в закупке и неликвиды с суммой замороженного капитала.
• Обзор прибыльности по товарам — выручка, маржа, класс товара по вкладу и остаток, отсортированные по марже.
• Рекламные кампании Wildberries — статус, тип ставки и оплаты, бюджет и темп его расхода.
• Отзывы покупателей Wildberries — честные сводные цифры по всему периоду (средняя оценка, доля негативных, доля без ответа) и выборка отдельных отзывов, отсортированная худшими вперёд.

Тексты, пришедшие от покупателей и из карточек, помечаются как недоверенные данные — это защита от попытки спрятать инструкцию для модели внутри отзыва или названия товара.

Через MCP доступен и второй набор — операции, меняющие что-то в маркетплейсе. Про них важно понять главное: они не меняют ничего сами. Каждый вызов создаёт заявку, которую человек подтверждает в разделе «Согласования».

Сейчас доступны: смена цены (Wildberries и Ozon), изменение остатка размера для схемы со склада продавца, правка габаритов упаковки, а также полный набор операций с рекламой Wildberries — пауза и запуск кампании, изменение ставки товара, переименование, места размещения, состав карточек кампании, ставка поискового кластера, минус-фразы, создание кампании, завершение, удаление и пополнение бюджета. Отдельно — добавление товара в акцию календаря.

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

1. Права токена. Их пять: читать аналитику, читать остатки, читать заказы, предлагать смену цен, предлагать смену остатков. Отмечаются при создании токена по отдельности.

2. Невидимость вместо запрета. Инструмент, не покрытый правами токена, не просто отклоняется при вызове — он вообще не появляется в списке доступных. Клиент не знает о его существовании, а значит, не может его вызвать по ошибке или по подсказке из недоверенного текста.

3. Роль. Права на изменение доступны только повышенной роли. Токен действует в рамках роли того, кто его выпустил: сотрудник с доступом на чтение не может выдать себе токен с правом менять цены.

4. Согласование. Даже с правом на изменение внешний агент создаёт заявку, а не изменение. Источник заявки виден в списке отдельной пометкой — вы всегда отличите действие внешнего агента от действия из интерфейса.

5. Отзыв и срок. Токен можно отозвать в один клик, задать ему срок жизни, а на странице видно, когда он использовался последний раз. Дополнительно действуют ограничения частоты запросов.

Ко всему этому добавляются числовые предохранители на странице «Предохранители цены» — минимальная цена, максимальное снижение за одно действие, лимиты трат на рекламу. Они применяются одинаково к любому источнику: интерфейсу, встроенному ассистенту и внешнему агенту.

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

Заказы. Список из общего представления обеих площадок с фильтрами по периоду, площадке, статусу и поисковой строке, с разбивкой по статусам. Выдача постраничная, поэтому большой период разбирается итеративно, а не одним гигантским ответом.

Товарный учёт. Четыре разных представления одним инструментом: сводка по складу; оборачиваемость вместе с прибыльностью по товарам; потребность в закупке с признаком «пора заказывать»; неликвиды с суммой замороженного капитала.

Обзор прибыльности по товарам. Выручка, маржа, класс товара по вкладу в результат и остаток, отсортированные по марже. Важно понимать, что это обзор всего ассортимента из витрины товарооборота, а не подробный P&L одного товара по датам реализации — это два разных среза, и смешивать их нельзя.

Рекламные кампании. Статус, тип ставки и оплаты, бюджет и темп его расхода — сколько дней хватит при текущей скорости. Завершённые и отклонённые кампании в выдачу не попадают.

Отзывы. Здесь возвращаются две разные вещи одновременно: сводка по всем отзывам периода (средняя оценка, доля негативных, доля без ответа, общее число) и выборка отдельных отзывов, отсортированная худшими вперёд и обрезанная лимитом. Для оценки картины годится только первая часть.

Деньги. Денежные величины передаются в копейках целым числом. Это сделано специально: округления в промежуточных вычислениях — главный источник расхождений при сверке.

Остатки. Это снимок на дату, а не показатель за период. При построении временных рядов остаток нельзя суммировать по дням как выручку.

Площадки. Показатели заказов и продаж сведены по обеим площадкам, а реклама собирается только по Wildberries. В строках Ozon рекламные колонки — отсутствие данных, а не ноль.

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

Недоверенные тексты. Названия товаров, имена брендов и тексты отзывов оборачиваются как данные, а не как указания. Это важно при построении собственных агентов: попытка внедрить инструкцию через текст отзыва не превратится в команду.