# wildberries-agent-integration [Health: Active] **Category:** 💻 Developer Tools **Repository:** https://github.com/BearsCLOUD/wildberries-agent-integration **GitHub Stars:** 0 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/wildberries-agent-integration ## Description Бесплатная русскоязычная аналитика Wildberries, SEO, калькуляторы и прогноз пополнения через MCP. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "wildberries-agent-integration": { "command": "npx", "args": ["-y","alpic"] } } ``` ## Documentation & README # Wildberries Agent Integration

Wildberries Agent Integration

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

CI Релиз Звёзды Лицензия MIT

Схема аналитики, калькуляторов и пополнения Wildberries через агента

Плагин соединяет агента с 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 ```bash 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: ```text /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-сервера: ```bash 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`. Для проверки манифеста: ```bash claude plugin validate plugins/wildberries-agent-integration ``` ### Локальный MCP ```bash 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: ```bash 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` либо выполните: ```bash npx alpic deploy \ --root-dir ./plugins/wildberries-agent-integration \ --runtime python3.13 ``` Не публикуйте deployment без production OAuth/Seller variables из [`deploy/README.md`](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/deploy/README.md). Один только health endpoint не доказывает работоспособность пользовательской аналитики. ## Как устроено подключение ```mermaid 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`](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/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`](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/public-listing.md), контракт MCP — в [`docs/mcp-contract.md`](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/mcp-contract.md), архитектурные ограничения — в [`SPEC.md`](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/SPEC.md). ## Документация - [Ландшафт конкурентов и источники](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/competitive-landscape.md) - [Граница агентской идентификации](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/identity-bridge.md) - [Доступ и mock-данные для ревьюера](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/reviewer-access.md) - [Подача в каталог OpenAI](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/openai-submission.md) - [Рекламный Playwright-сценарий](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/examples/marketing-video-playwright.json) - [Подача в каталог Claude](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/docs/anthropic-submission.md) - [Безопасность](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/SECURITY.md) - [Приватность](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/plugins/wildberries-agent-integration/PRIVACY.md) - [Условия использования](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/plugins/wildberries-agent-integration/TERMS.md) - [Поддержка](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/SUPPORT.md) - [История изменений](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/plugins/wildberries-agent-integration/CHANGELOG.md) - [Social preview 1280×640](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/assets/social-preview.png)

Deploy on Alpic

## Лицензия MIT — [LICENSE](https://github.com/BearsCLOUD/wildberries-agent-integration/blob/HEAD/LICENSE).