WB Readonly MCP

ИИ-помощник для своего кабинета Wildberries: товары, реклама, заказы, остатки, воронка, отзывы, тарифы и финансовые документы. Сервер получает данные WB, а ChatGPT, Cursor или другой MCP-клиент помогают их разбирать.

Изменять WB через этот проект нельзя. Доступны 12 инструментов MCP и 181 разрешённая операция API из 13 разделов. Для редких задач есть поиск по каталогу и точные схемы параметров. Новые методы автоматически не включаются.

Начать установку → DEPLOY.md · Примеры запросов · Инструкция для любой ИИ · Полный каталог

Что полезного менеджеру

Доступность зависит от категорий и типа токена, модели работы продавца, подписок WB и текущей версии API. «Есть в каталоге» не означает, что WB предоставит метод каждому кабинету.

Related MCP server: marketplaces-mcp-ru

Как это устроено

ChatGPT / Cursor / совместимый MCP-клиент
                  ↓ HTTPS + OAuth
     Cloudflare: постоянный домен или workers.dev
                  ↓ Tunnel
       Ваш VPS → WB Readonly MCP → API WB
                       ↓
            локальные результаты и расчёты

Токен WB хранится на VPS. В окно подключения ИИ вводится отдельный пароль MCP. Для Cursor также доступны локальный запуск через stdio и дополнительный статический ключ MCP. Это один кабинет и общая доверенная команда: разграничения товаров и финансов между сотрудниками нет.

Cloudflare даёт внешний HTTPS-адрес. Если нужен адрес вне зоны .ru, предусмотрен вход через *.workers.dev. С сервера должен работать доступ к API WB; Cloudflare не меняет этот исходящий маршрут.

Поиск товара без лишних вопросов

«Разбери товар 123456789» → сервер получает карточку, определяет subjectId, название предмета и родительскую категорию, читает характеристики и цены. Вручную указывать категорию при известном артикуле обычно не нужно.

«Найди белые носки» → поиск по своему каталогу. При нескольких совпадениях ИИ показывает варианты. Для большого каталога возвращаются признак неполной выборки и курсор продолжения.

Почему запись недоступна

• Токен WB с правами записи отклоняется до сетевого запроса. Проверяется признак «Только чтение» в токене; подлинность и права окончательно проверяет WB.

• Вызов разрешён только для точного сочетания операции, метода, пути и домена из catalog/allowlist.json.

• ИИ не может задать произвольный URL, заголовки, другой токен или HTTP-метод. Перенаправления API не выполняются.

• Изменяющие операции исключены даже при использовании GET. POST для получения данных допускается только по списку.

• Создание и повторный запуск фоновых отчётов WB исключены. Можно читать уже готовые отчёты при наличии их ID и доступа.

• Все инструменты объявлены в MCP как read-only; реальное ограничение действует в коде, а не только в подсказке ИИ.

Сохранение ответов и OAuth-подключений на собственном сервере не изменяет кабинет WB.

Инструменты MCP

Есть встроенная инструкция wb://guide и шаблон wb_daily_review. Шаблон запускается по запросу, автоматического ежедневного расписания нет.

Быстрый старт разработчика

Нужен Node.js 22 или новее.

git clone https://github.com/zimuspro156-lab/mcp-wb-readonly.git
cd mcp-wb-readonly
npm ci
npm test
npm run check
npm run setup

Настройте .env, добавьте персональный токен WB с правами только чтения, затем npm run start:http. Для сервера с автозапуском используйте полную инструкцию. Для локального Cursor — раздел «Локальный Cursor» в ней.

Границы текущей версии

• Реализованы и проверены локально MCP, ограничения запросов, OAuth и аналитические расчёты. Тесты используют подставные ответы WB; проверка реальным токеном вашего кабинета ещё нужна.

• Каталог основан на датированном снимке API от 19.08.2026 с дополнением полных схем. Прямое получение части документации WB во время разработки было недоступно. Происхождение и ограничения описаны в PROVENANCE.md.

• Одна операция с неполной схемой отключена. Это настройки автовозвратов FBS для конкретных товаров. Все 104 исключённые операции перечислены отдельно.

• Получение готового ZIP/PDF возвращает сохранённое содержимое/base64. Автоматической распаковки и распознавания PDF нет. Для аналитики удобнее выбирать JSON-детализации.

• Нет доступа к закрытым данным конкурентов, автоматического обхода платных подписок или гарантированной «чистой прибыли» без ваших затрат.

• Docker-конфигурация подготовлена, но сборка Docker и установка на Linux VPS в среде разработки не выполнялись. Основной путь установки — отдельные службы systemd.

Исходный код — MIT. Проект не является официальным продуктом Wildberries.