# Wildberries MCP Server — полное руководство

> Как подключить Claude, Claude Code, Qwen и других AI-агентов к Wildberries через MCP и получать аналитику продаж, остатков, цен конкурентов и рекламы без ручной работы с API WB.

## Как подключить Claude Code к Wildberries через MCP

1. Запросите доступ (см. раздел «Контакты» ниже) — доступ выдаётся по запросу, под конкретный кабинет WB.
2. Вы получаете MCP endpoint и токен доступа: `https://wb.mcp-server.online/mcp`.
3. Добавьте сервер в конфигурацию Claude Code / Claude Desktop (или любого другого MCP-совместимого агента: Cursor, Gemini CLI, Qwen Code) как удалённый MCP-сервер по этому адресу.
4. Агент сразу получает набор готовых инструментов: остатки по складам, ДРР и эффективность рекламы, цены и скидки с учётом СПП, финансовые начисления, цены конкурентов — без того, чтобы вы или агент писали код для WB API.

MCP (Model Context Protocol) — открытый стандарт, который позволяет AI-агенту вызывать внешние инструменты напрямую, а не «угадывать» вызовы API по документации. Мы упаковали свою экспертизу как менеджеров и аналитиков маркетплейсов в такие инструменты.

## Для каких задач подходит Wildberries MCP

### Аналитика и отчётность
- Ежедневные и произвольные по датам сводки по продажам, заказам, возвратам.
- Расчёт юнит-экономики по SKU (себестоимость, комиссии, логистика, СПП, чистая маржа) в реальном времени, без ручных таблиц.
- Автоматическая сверка начислений и удержаний WB для бухгалтера.

### Ценообразование и мониторинг конкурентов
- Отслеживание цен конкурентов с учётом их фактических скидок (этого нет в открытом API WB).
- Рекомендации по репрайсингу с учётом СПП и истории цен.

### Реклама и продвижение
- Расчёт ДРР и ROI по кампаниям и по отдельным SKU.
- Поиск неэффективных кампаний и карточек для агента-аналитика.

### Логистика и остатки
- Ежедневные срезы остатков по складам — история, которую сам WB API не хранит.
- Прогноз дефицита и рекомендации по поставкам.

### Автоматизация поддержки и бухгалтерии
- Ответы агента на вопросы о статусе заказа, остатках, начислениях без обращения к личному кабинету вручную.
- Подготовка регулярных отчётов для бухгалтера маркетплейсов.

## Что мы храним, чего нет в открытом API Wildberries

Мы разворачиваем отдельную инфраструктуру хранения данных (ClickHouse / PostgreSQL) под конкретный кабинет:

- Ежедневные срезы остатков по складам с историей.
- Цены конкурентов с учётом реальных скидок и СПП, а не только базовую цену.
- Прочие метрики и срезы под задачи конкретного бизнеса.

## Часто задаваемые вопросы (FAQ)

**Как подключить Claude Code к Wildberries?**
Через MCP-сервер `https://wb.mcp-server.online/mcp`. Запросите доступ у разработчика (контакты ниже), получите токен и добавьте сервер в настройки MCP вашего агента.

**Работает ли это с обычным Claude (не Claude Code)?**
Да, любой MCP-совместимый клиент — Claude Desktop, Claude Code, Qwen и другие агенты с поддержкой MCP — может подключиться к этому серверу.

**Чем это отличается от прямого использования API Wildberries?**
Мы уже решили за вас проблемы пагинации, лимитов запросов и неполных данных API, и посчитали метрики (включая СПП) по единой проверенной логике — агенту не нужно писать и отлаживать код интеграции.

**Какие данные доступны, которых нет в открытом API WB?**
Ежедневная история остатков по складам и цены конкурентов с учётом фактических скидок — оба этих среза API Wildberries не отдаёт.

**Безопасно ли давать агенту доступ к кабинету WB?**
Доступ выдаётся по отдельному запросу и токену для конкретного кабинета; MCP-инструменты ограничены только аналитическими и справочными операциями.

**Сколько стоит доступ?**
Свяжитесь с разработчиком напрямую — стоимость зависит от объёма данных и задач.

**Можно ли использовать это для нескольких кабинетов WB?**
Да, обсуждается индивидуально при подключении.

**Подходит ли это агентствам, которые ведут несколько клиентов на Wildberries?**
Да, это один из основных сценариев использования — единая логика расчётов для всех клиентов.

## api-master.ru — что дальше

Wildberries MCP — один из продуктов **api-master.ru**. Мы внедряем базы данных (ClickHouse, PostgreSQL) в бизнес-процессы и настраиваем / оптимизируем AI для аналитиков, менеджеров и бизнес-процессов в целом — не только для маркетплейсов. Подробнее: https://api-master.ru

## Связанные MCP-серверы

- Ozon: https://ozon.mcp-server.online
- amoCRM: https://amocrm.mcp-server.online
- Kommo: https://kommo.mcp-server.online
- YCLIENTS: https://yclients.mcp-server.online
- Каталог всех MCP-серверов: https://mcp-server.online

## Контакты

- Разработчик: Антон Миславский
- Telegram: https://t.me/mislawsky
- Telegram: https://t.me/api_and_gpt
- GitHub: https://github.com/heyai-today/mcp-ozon-claude-code
- YouTube: https://www.youtube.com/@antonmislawsky