$git clone https://github.com/ilyautov/marketplaces-mcp-ruMCP-сервер для кабинетов Wildberries и Ozon: продажи, остатки, цены, финансы, отзывы через Seller API напрямую, без браузера. 793 метода schema-driven, safety-гейт на запись. Подключает ИИ (Claude Code, Cursor, Codex, ChatGPT) к API WB и Ozon. Open-source MIT.
| 1 | # marketplaces-mcp-ru: Wildberries и Ozon в вашем ИИ-ассистенте |
| 2 | |
| 3 | <!-- mcp-name: io.github.ilyautov/marketplaces-mcp-ru --> |
| 4 | |
| 5 | > 🇬🇧 [English version](README.en.md) |
| 6 | |
| 7 | Подключает ИИ-ассистента (Claude, Cursor, Codex, Cowork и др.) напрямую к вашим кабинетам Wildberries и Ozon. Вы спрашиваете обычными словами, агент берёт продажи, остатки, цены, финансы и отзывы прямо из API маркетплейса, а не выдумывает цифры. |
| 8 | |
| 9 | [](https://pypi.org/project/marketplaces-mcp-ru/) |
| 10 | [](https://registry.modelcontextprotocol.io/) |
| 11 | [](LICENSE) |
| 12 | [](#как-это-устроено) |
| 13 | [](https://marketplaces-mcp-ru.aifrontier.tech/) |
| 14 | [](https://github.com/ilyautov/marketplaces-mcp-ru/stargazers) |
| 15 | |
| 16 | <!-- social preview: assets/social-preview.png → Settings → Social preview. |
| 17 | Сайт: marketplaces-mcp-ru.aifrontier.tech (GitHub Pages из docs/). --> |
| 18 | |
| 19 | ## Зачем |
| 20 | |
| 21 | Вы продаёте на двух площадках, а данные лежат в двух разных кабинетах. Продажи, остатки, цены, финансы, отзывы: всё руками, по очереди, через два браузера. Обычный ИИ-ассистент тут мало помогает. Либо ходит через браузер и спотыкается о капчу, либо называет цифры, которые звучат уверенно, но взяты из воздуха. |
| 22 | |
| 23 | Этот проект решает задачу иначе. Он даёт ассистенту прямой доступ к Seller API обоих кабинетов: |
| 24 | |
| 25 | - Цифры приходят из ответа Wildberries и Ozon, с указанием источника и полей. Не пересказ, не догадка. |
| 26 | - Перед тем как менять цену или остаток, агент просит подтверждение. Случайно «уронить цену в три раза» не получится. |
| 27 | - Никакого браузера и капчи: обращение идёт по токену кабинета напрямую. |
| 28 | |
| 29 | Спросите обычными словами: «покажи продажи за неделю на обоих», «что пора дозаказать», «сравни мои цены с рынком». Агент подберёт нужный метод или готовый сценарий и проведёт по шагам. |
| 30 | |
| 31 | > ⚠️ Версия alpha. Помогает с операционкой продавца, но это инструмент, а не замена аналитику. Проверенное вручную ядро (продажи, остатки, цены, финансы, отзывы) выверено на реальных кабинетах. Остальные методы импортированы из спецификаций и служат картой для разведки. Подробности в разделе [Оговорки](#оговорки). |
| 32 | |
| 33 | ## Что можно спросить |
| 34 | |
| 35 | Просто пишите агенту в чат по-русски: |
| 36 | |
| 37 | ``` |
| 38 | покажи продажи за неделю на WB и Ozon и сравни |
| 39 | что пора дозаказать, посчитай дни покрытия по остаткам и продажам |
| 40 | вытащи финотчёт реализации WB за прошлый месяц |
| 41 | какие товары на Ozon с красным индексом цены |
| 42 | собери отзывы ниже 4 звёзд за неделю и сгруппируй жалобы по товару |
| 43 | сделай ABC-анализ по выручке и покажи товары-хвост |
| 44 | ``` |
| 45 | |
| 46 | Не знаете, с чего начать, скажите «что ты умеешь по моему кабинету». Агент покажет готовые сценарии: для Wildberries это пульс продаж, здоровье остатков, аудит цен, планировщик дозаказа, ABC-анализ, сводка отзывов; для Ozon: риск out-of-stock, анализ цен, юнит-экономика, синхронизация каталога, аудит контента и те же ABC и отзывы. Каждый сценарий это пошаговый рецепт с трактовкой результата и типичными ошибками. |
| 47 | |
| 48 | ## Установка |
| 49 | |
| 50 | Подробный гайд под любую аудиторию лежит в [QUICKSTART.md](QUICKSTART.md). Несколько способов, результат один. |
| 51 | |
| 52 | 1. **Claude Desktop в один клик (`.mcpb`).** Возьмите `marketplaces-mcp-ru-v<версия>.mcpb` из [GitHub Releases](https://github.com/ilyautov/marketplaces-mcp-ru/releases) и дважды кликните — Claude Desktop сам поставит расширение и спросит ключи в окне настроек. Без терминала и без Gatekeeper. Один бандл поднимает WB + Ozon + Ozon Performance сразу. |
| 53 | 2. **Попросить своего ИИ (без терминала).** Откройте Claude или Cowork и скажите: «установи WB + Ozon MCP». Агент проведёт по встроенному скиллу `install-skill/`. В песочнице Cowork финальный клик остаётся за вами; в Claude Code установка проходит полностью сама. |
| 54 | 3. **Скачать и кликнуть.** Возьмите `marketplaces-mcp-ru-v<версия>.zip` из [GitHub Releases](https://github.com/ilyautov/marketplaces-mcp-ru/releases), распакуйте, дважды кликните `install.command` (macOS) или `install.bat` (Windows), вставьте ключи. На macOS при первом запуске: правый клик → «Открыть» → «Открыть» (так обходится Gatekeeper для скачанного файла). |
| 55 | 4. **Через терминал.** `git clone https://github.com/ilyautov/marketplaces-mcp-ru`, затем `python3 install.py --client <ваш-клиент>`. |
| 56 | 5. **Для разработчиков (`uvx`).** `uvx marketplaces-mcp-ru` запускает объединённый сервер прямо из PyPI; отдельные серверы — консольными командами `wb-mcp` / `ozon-mcp` / `ozon-perf-mcp`. Ключи — через переменные окружения или те же `*_add_cabinet` из чата. |
| 57 | |
| 58 | Установщик копирует приложение в стабильную папку (`~/.marketplace-mcp/app`) и привязывает конфиг туда, |