Wildberries Agent Integration
概览
作者提供的说明(英文原文)
Бесплатная русскоязычная аналитика Wildberries, SEO, калькуляторы и прогноз пополнения через MCP.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i1 项中通过 1 项依据公开信息检查;尚未扫描代码
- 使用情况i非常新★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: Streamable HTTP
- 分类: 营销与社交媒体
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:1 项中通过 1 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 注册中心没有列出需要填写的密钥。
你需要
- 在云端运行无需安装任何东西,通过互联网连接
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
- 打开 Settings → Connectors
- 点击 Add custom connector
- 粘贴下面的地址,然后点击 Add
- 如果要求登录,请登录作者的服务
https://wb.seller.bears.ru/mcp在终端中运行这条命令
claude mcp add --transport http wildberries-agent-integration https://wb.seller.bears.ru/mcp或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"wildberries-agent-integration": {
"url": "https://wb.seller.bears.ru/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"wildberries-agent-integration": {
"type": "http",
"url": "https://wb.seller.bears.ru/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
- 打开网页版 ChatGPT → Settings → Connectors (Apps)
- 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
- 粘贴下面的地址,起个名字,然后保存
- 如果要求登录,请登录作者的服务
https://wb.seller.bears.ru/mcp菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
我们还没有读取这个服务器的工具列表;我们会轮流检查各个端点。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 BearsCLOUD 验证,该账户拥有此仓库
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
端点有响应
尚未检查;我们会轮流检查各个端点
- … 尚未检查
使用 OAuth 登录
尚未检查;我们会轮流检查各个端点
- … 尚未检查
工具描述中没有隐藏指令
尚未检查;我们会在检查端点时读取工具列表
与“营销与社交媒体”中的其他服务器比较i
- 星标数多于此分类中其他 3593 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 3593 个服务器的 31% 更新
- 基础检查结果等于或优于此分类中其他 3593 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Wildberries Agent Integration 安全吗?
它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于–,最新版本(0.1.26)于2个月前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
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
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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.