Wildberries Agent Integration
Overview
Description from the maker (original English)
Бесплатная русскоязычная аналитика Wildberries, SEO, калькуляторы и прогноз пополнения через MCP.
PopNx MCP’s three pillars
These three are never merged into one score: opinions, measurements and popularity are different things.
- User voiceiNo reviews yetReviews open together with accounts in a later step
- Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
- UsageiVery new★ –
What you can do with it
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
- Connection: Runs in the cloud
- Transport: Streamable HTTP
- Category: Marketing & social media
Install
Pick the AI app you use, then copy the settings.
Before you install
- Basic checks: 1 of 1 passed
- Runs on the maker’s server: what you ask it goes through their server.
- The registry lists no key to fill in.
You need
- Runs in the cloudNothing to install; it connects over the internet
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
- Open Settings → Connectors
- Press Add custom connector
- Paste the address below and press Add
- If it asks you to sign in, sign in with the maker
https://wb.seller.bears.ru/mcpRun this in your terminal
claude mcp add --transport http wildberries-agent-integration https://wb.seller.bears.ru/mcpOr copy the settings yourself
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"wildberries-agent-integration": {
"url": "https://wb.seller.bears.ru/mcp"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Or copy the settings yourself
Paste into .vscode/mcp.json in your project
{
"servers": {
"wildberries-agent-integration": {
"type": "http",
"url": "https://wb.seller.bears.ru/mcp"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
- Open ChatGPT on the web → Settings → Connectors (Apps)
- Press Create or Add (some plans need Developer mode under Advanced first)
- Paste the address below, give it a name and save
- If it asks you to sign in, sign in with the maker
https://wb.seller.bears.ru/mcpMenu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
What it can do
We have not read this server’s tool list yet; we check endpoints in rotation.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account BearsCLOUD, which owns the repo
- … Not checked yet
Still maintained
We have not read this repo from GitHub yet
- … Not checked yet
Has a licence
We have not read this repo from GitHub yet
- … Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
- … Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
- … Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint
Compared with others in Marketing & social mediai
- More stars than 0% of the other 3593 servers in this category
- Published to the registry more recently than 31% of the other 3593 servers in this category
- Basic checks equal to or better than 100% of the other 3593 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Wildberries Agent Integration safe?
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed –, and the latest version (0.1.26) reached the registry 2 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
What can I use instead?
In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
Alternatives
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Wildberries Agent Integration
Бесплатная русскоязычная аналитика Wildberries для Codex, Claude и MCP-клиентов
Плагин соединяет агента с 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.
Документация
- Ландшафт конкурентов и источники
- Граница агентской идентификации
- Доступ и mock-данные для ревьюера
- Подача в каталог OpenAI
- Рекламный Playwright-сценарий
- Подача в каталог Claude
- Безопасность
- Приватность
- Условия использования
- Поддержка
- История изменений
- Social preview 1280×640
Лицензия
MIT — LICENSE.