English Français العربية

io.github.BearsCLOUD/wildberries-agent-integration

Registre officiel Marketing et ventes

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http wildberries-agent-integration 'https://wb.seller.bears.ru/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "wildberries-agent-integration": {
            "type": "http",
            "url": "https://wb.seller.bears.ru/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Wildberries Agent Integration
  2. В двух словах
  3. Калькулятор и пополнение
  4. Возможности
  5. Быстрый старт
  6. Как устроено подключение
  7. 16 навыков
  8. Ограничения и честный статус
  9. Документация
  10. Лицензия

Wildberries Agent Integration

Бесплатная русскоязычная аналитика Wildberries для Codex, Claude и MCP-клиентов

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

В двух словах

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

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

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

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

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

Возможности

ГруппаЧто умеет агент
АналитикаПродажи, заказы, финансы, цены, остатки и сводки за период
РешенияЮнит-экономика, маржа, точка безубыточности, цена и пополнение
РынокЯвно переданные наблюдения конкурентов и конкурентный ценовой коридор
РепутацияОтзывы, средняя оценка, повторяющиеся жалобы и список без ответа
ГеографияПродажи в разрезе товара и доступного региона; локальные дефициты
ГипотезыСопоставление продаж с погодой без заявления причинности
Контент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.

Questions fréquentes

Qu'est-ce que io.github.BearsCLOUD/wildberries-agent-integration ?

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

Comment installer io.github.BearsCLOUD/wildberries-agent-integration ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http wildberries-agent-integration 'https://wb.seller.bears.ru/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.BearsCLOUD/wildberries-agent-integration ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.BearsCLOUD/wildberries-agent-integration est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.BearsCLOUD/wildberries-agent-integration ?

Il est publié par BearsCLOUD. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.