How do I install Wildberries Agent Integration?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Wildberries Agent Integration need an API key?

No required environment variable is listed on this record.

What transport does Wildberries Agent Integration use?

Wildberries Agent Integration is reached over HTTP.

When was Wildberries Agent Integration last checked?

Last checked 2026-11-08. Бесплатная русскоязычная аналитика Wildberries, SEO, калькуляторы и прогноз пополнения через MCP.

Wildberries Agent Integration MCP server

Wildberries Agent Integration

Плагин соединяет агента с Seller и даёт продавцу понятный путь от вопроса к числу и следующему действию: продажи, остатки, конкуренты, цены, регионы, SEO, контент карточки, юнит-экономика и пополнение. Агентский функционал бесплатен: у проекта нет платы за лицензию, место пользователя или вызов инструмента.

В двух словах

16 русскоязычных навыков и 17 MCP-инструментов.
Безопасное подключение поставщика через seller.bears.ru: исходный WB-токен не вводится в чат.
Отдельный калькулятор пополнения и прогноз «сколько и куда везти».
Конкурентный анализ, ценовой коридор, продажи по доступному региональному полю, погодные гипотезы и SEO-оценка.
Подготовка карточки, дизайн-системы и фото товара — без автоматической публикации в Wildberries.
MIT, открытый исходный код, бесплатная агентская поверхность.

Калькулятор и пополнение

Это центральный операционный сценарий плагина:

wb_replenishment_math быстро считает количество единиц по дневному спросу, остатку, товару в пути и целевому покрытию.
wb_inventory_forecast учитывает доступные остатки и спрос, предлагает направления по складам или регионам и показывает допущения.
Если складская география недоступна, результат честно помечается как региональная эвристика — без выдуманного распределения.

Калькуляторы ничего не заказывают и не меняют остатки. Это воспроизводимая рекомендация для планирования.

Возможности

Группа	Что умеет агент
Аналитика	Продажи, заказы, финансы, цены, остатки и сводки за период
Решения	Юнит-экономика, маржа, точка безубыточности, цена и пополнение
Рынок	Явно переданные наблюдения конкурентов и конкурентный ценовой коридор
Репутация	Отзывы, средняя оценка, повторяющиеся жалобы и список без ответа
География	Продажи в разрезе товара и доступного региона; локальные дефициты
Гипотезы	Сопоставление продаж с погодой без заявления причинности
Контент	SEO-проверка, структура карточки, дизайн-система и варианты фото
Интеграция	Защищённая регистрация, запись себестоимости и allowlist Seller Gateway

MCP-инструменты

Инструмент	Назначение
`wb_connect_supplier`	Открыть одноразовый защищённый сценарий привязки Seller
`wb_connection_status`	Проверить привязку Seller и список поставщиков
`wb_connect_telegram`	Открыть существующий сценарий подключения Telegram
`wb_list_suppliers`	Показать поставщиков текущего пользователя
`wb_analytics_summary`	Сводка продаж, заказов, финансов, цен и остатков
`wb_warehouse_stock`	Остатки по товару и складам
`wb_wildberries_proxy`	Фиксированные read-only операции Seller Gateway
`wb_refresh_analytics`	Поставить обновление аналитики в существующую очередь Seller
`wb_competitor_analysis`	Сравнение с явно переданными конкурентами
`wb_competitive_price`	Коридор цены и проверяемые сценарии
`wb_sales_by_region`	Продажи по доступному региональному полю
`wb_sales_weather_impact`	Корреляция продаж и погодных рядов
`wb_seo_analytics`	Проверка контента карточки и поисковых ключей
`wb_upload_cost_price`	Двухшаговая перезапись указанной себестоимости в Seller с токеном, связанным с параметрами
`wb_unit_economics`	Маржа, безубыточность и сценарии
`wb_replenishment_math`	Быстрый расчёт количества пополнения
`wb_inventory_forecast`	Прогноз количества и направлений пополнения

Быстрый старт

Codex

git clone https://github.com/BearsCLOUD/wildberries-agent-integration.git
cd wildberries-agent-integration
codex plugin marketplace add ./.agents/plugins
codex plugin add wildberries-agent-integration@wildberries-agent

Каталог плагина описан в .agents/plugins/marketplace.json, манифест — в plugins/wildberries-agent-integration/.codex-plugin/plugin.json. Плагин сам объявляет public MCP и динамически регистрирует OAuth client. OAuth создаёт анонимную агентскую сессию; Seller подключается затем по одноразовой ссылке. Вводить WB-токен в терминал или чат не нужно.

Claude

Установите плагин с шестнадцатью навыками и публичным MCP в Claude Code:

/plugin marketplace add BearsCLOUD/wildberries-agent-integration
/plugin install wildberries-agent-integration@wildberries-agent

Это каталог BearsCLOUD, а не официальный каталог Anthropic.

Для hosted Claude Connector укажите https://wb.seller.bears.ru/mcp; Seller OAuth регистрирует public client через DCR и PKCE S256.

Для Claude Code подключите публичный MCP без локального Python-сервера:

claude mcp add --transport http wildberries-agent https://wb.seller.bears.ru/mcp

Откройте /mcp в Claude Code и пройдите авторизацию Seller в браузере. Токен Wildberries вводится только в Seller, не в конфигурацию Claude.

Манифест Claude находится в plugins/wildberries-agent-integration/.claude-plugin/plugin.json, а готовая конфигурация — в plugins/wildberries-agent-integration/claude/mcp.json. Для проверки манифеста:

claude plugin validate plugins/wildberries-agent-integration

Локальный MCP

cd plugins/wildberries-agent-integration
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e .
export APP_ENV=development
export SELLER_GATEWAY_URL=http://127.0.0.1:8000
export SELLER_CONNECT_URL=https://seller.bears.ru/authentication/registration
wildberries-agent-mcp

Для Streamable HTTP:

wildberries-agent-mcp --transport streamable-http --host 127.0.0.1 --port 8080

Локальный сервер требует доступный Seller Gateway для авторизованных аналитических вызовов. В production дополнительно нужны HTTPS, SELLER_GATEWAY_URL, MCP_PUBLIC_URL и MCP_AUTH_ISSUER. MCP передаёт Gateway только непрозрачный агентский bearer и никогда не получает Seller bearer.

Alpic

В репозитории есть явный alpic.json. Для импорта укажите root directory plugins/wildberries-agent-integration либо выполните:

npx alpic deploy \
  --root-dir ./plugins/wildberries-agent-integration \
  --runtime python3.13

Не публикуйте deployment без production OAuth/Seller variables из deploy/README.md. Один только health endpoint не доказывает работоспособность пользовательской аналитики.

Как устроено подключение

flowchart LR
    A[Codex / Claude] --> B[Публичный MCP]
    B -->|opaque OAuth bearer| D[Seller Gateway]
    D --> E[Seller analytics]
    D --> F[Хранимая WB credential]
    U[Продавец] -->|токен только в браузере| S[seller.bears.ru]
    S --> D

wb_wildberries_proxy — не произвольный HTTP-прокси. Агент передаёт только supplier_id_wb, имя разрешённой операции и ограниченный payload. Он не видит токен, URL, HTTP-метод, путь или заголовки. Seller Gateway проверяет владельца и область поставщика, а затем сам выбирает хранимую credential. Единственные записи в текущем наборе — явно указанная себестоимость товара и постановка существующего обновления аналитики Seller в очередь; данные Wildberries не изменяются.

16 навыков

Все навыки русскоязычные и лежат в plugins/wildberries-agent-integration/skills:

analytics-summary · connect-supplier · cost-price-upload · unit-economics · replenishment-calculator · inventory-forecast · competitor-analysis · competitive-pricing · regional-sales · weather-impact · seo-analytics · product-card · design-system · product-photo-generation · review-analysis · wildberries-api.

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

Ограничения и честный статус

Конкуренты анализируются только по переданному или разрешённому источнику; полнота рынка не обещается.
Ценовой коридор описывает выборку, но не доказывает спрос или прибыльность.
Регион — только фактическое географическое поле источника, а не автоматически выведенный регион покупателя.
Погода показывает корреляцию совпавших рядов, а не причинное влияние и не прогноз продаж.
SEO — прозрачная эвристика контента, а не гарантия позиции, CTR или конверсии.
Внешние данные (конкуренты, погода) требуют совместимого API и соответствующей лицензии.

Публичный MCP https://wb.seller.bears.ru/mcp, Seller OAuth 2.1/PKCE, reviewer sandbox и reviewed WB API contracts развёрнуты и функционально проверены. Публикация в каталоге ChatGPT/OpenAI остаётся отдельным этапом: для неё нужны проверка домена, заполненный черновик карточки и отправка на ревью оператором.

Порядок подачи описан в docs/public-listing.md, контракт MCP — в docs/mcp-contract.md, архитектурные ограничения — в SPEC.md.

Документация

Лицензия

MIT — LICENSE.

Wildberries Agent Integration

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Wildberries Agent Integration?

Does Wildberries Agent Integration need an API key?

What transport does Wildberries Agent Integration use?

When was Wildberries Agent Integration last checked?

Documentation

Wildberries Agent Integration

В двух словах

Калькулятор и пополнение

Возможности

MCP-инструменты

Быстрый старт

Codex

Claude

Локальный MCP

Alpic

Как устроено подключение

16 навыков

Ограничения и честный статус

Документация

Лицензия