The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Wildberries MCP
MCP server for Wildberries — marketplace orders, analytics, stock (Russia). Part of WWmcp — 46 MCP servers for emerging markets.
Install
$
npx @smithery/cli install @theyahia/wildberries-mcpClaude Code
claude mcp add wildberries-mcp -- npx @smithery/cli install @theyahia/wildberries-mcpCursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"wildberries-mcp": {
"command": "npx",
"args": [
"@smithery/cli",
"install",
"@theyahia/wildberries-mcp"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →MCP-сервер для Wildberries Seller API — 30 инструментов для ИИ-агента
Если вы искали, как подключить кабинет продавца Wildberries к Claude или другому ИИ-агенту, — этот сервер даёт агенту прямой доступ к Seller API: остатки и цены, заказы и продажи, поставки FBS, аналитика, отзывы, вопросы, возвраты и реклама. Спрашиваете обычными словами — «какие товары кончаются на складе Коледино», «подними цену на SW-4410 до 3490 ₽» — и получаете готовый ответ таблицей, а не выгрузку, которую ещё надо разбирать. Маршрутизация по хостам категорий, соблюдение лимитов запросов и защита от 409-штрафа — на стороне сервера.
Быстрый старт
npm install -g @theyahia/wildberries-mcp
# транспорт stdio (для Claude Desktop, Cursor и других)
WB_API_TOKEN=your_token wildberries-mcp
# транспорт Streamable HTTP
WB_API_TOKEN=your_token wildberries-mcp --http
Claude Desktop
Добавьте в claude_desktop_config.json:
{
"mcpServers": {
"wildberries": {
"command": "npx",
"args": ["-y", "@theyahia/wildberries-mcp"],
"env": { "WB_API_TOKEN": "your_token_here" }
}
}
}
Cursor, Windsurf и VS Code (Copilot) используют тот же блок mcpServers в своих настройках MCP.
Smithery
npx @smithery/cli install @theyahia/wildberries-mcp
Авторизация и категории токена
Authorization: Bearer {WB_API_TOKEN} (JWT, срок жизни 180 дней). Токен выдаётся в
кабинете продавца в разделе
Настройки → Доступ к API.
Один токен может нести сразу несколько категорий доступа. Поскольку каждый инструмент ходит
на свой хост API, при отсутствующей категории 401 вернёт именно этот хост, а остальные
инструменты продолжат работать. Включайте нужные категории:
| Категория | Какие инструменты питает |
|---|---|
| Контент | list_products, get_product |
| Цены и скидки | update_prices |
| Маркетплейс | update_stocks, get_stocks, get_orders, get_new_orders, get_warehouses, get_supply, create_supply, add_orders_to_supply, deliver_supply, get_supply_barcode |
| Статистика | get_sales, get_incomes, get_fbw_stocks, get_statistics, get_abc_analysis |
| Аналитика | get_funnel, get_paid_storage |
| Тарифы (Общее) | get_commission, get_tariffs |
| Отзывы и вопросы | get_feedbacks, reply_feedback, get_questions, reply_question |
| Возвраты | get_returns |
| Реклама | get_balance, list_campaigns, get_campaign_stats |
Когда вызов падает, в тексте ошибки указан хост и requestId от WB, поэтому недостающая категория
или ошибка с хостом видны сразу (например, WB API GET advert-api.wildberries.ru/adv/v1/balance → 401: ...).
Архитектура — хост на каждую категорию
Seller API Wildberries — это не единый шлюз. seller.wildberries.ru — это веб-кабинет,
а API разнесён по хостам категорий. Каждый запрос маршрутизируется на нужный:
| Категория | Хост |
|---|---|
| Контент | content-api.wildberries.ru |
| Цены и скидки | discounts-prices-api.wildberries.ru |
| Маркетплейс (FBS) | marketplace-api.wildberries.ru |
| Статистика | statistics-api.wildberries.ru |
| Аналитика | seller-analytics-api.wildberries.ru |
| Общее / Тарифы | common-api.wildberries.ru |
| Отзывы и вопросы | feedbacks-api.wildberries.ru |
| Возвраты | returns-api.wildberries.ru |
| Реклама | advert-api.wildberries.ru |
Инструменты (30)
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)