MCP-сервер аналитики Wildberries

Wildberries Analytics MCP

MCP-сервер аналитики продавца Wildberries: воронка продаж, поисковые отчеты, остатки по складам и CSV-выгрузки

dias-zhanabayev/wildberries_mcpАвтор:dias-zhanabayev

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/wildberries-analytics-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'WILDBERRIES_TOKEN=<ваш WILDBERRIES_TOKEN>' wildberries -- uvx --directory '/полный/путь/к/wildberries-mcp' run main.py

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"wildberries","type":"stdio","command":"uvx","args":["--directory","/полный/путь/к/wildberries-mcp","run","main.py"],"env":{"WILDBERRIES_TOKEN":"<ваш WILDBERRIES_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "wildberries": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add wildberries --env 'WILDBERRIES_TOKEN=<ваш WILDBERRIES_TOKEN>' -- uvx --directory '/полный/путь/к/wildberries-mcp' run main.py

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.wildberries]
command = "uvx"
args = ["--directory", "/полный/путь/к/wildberries-mcp", "run", "main.py"]
env = { WILDBERRIES_TOKEN = "<ваш WILDBERRIES_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "wildberries": {
      "type": "local",
      "command": [
        "uvx",
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "environment": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<ваш WILDBERRIES_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WILDBERRIES_TOKENсекрет, обязательная: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 10e4bce.

Текст для агента

Установи uv, склонируй wildberries_mcp, выполни uv sync, скопируй example.env в .env и вставь WILDBERRIES_TOKEN из личного кабинета продавца, затем добавь сервер в конфигурацию клиента командой uv run main.py.

Другие способы из описания автора

git clone https://github.com/dias-zhanabayev/wildberries_mcp && cd wildberries_mcp && uv sync

Клонирование и установка зависимостей через uv.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает аналитические отчеты Wildberries к Claude Desktop и Cursor. Инструменты разбиты на четыре группы: воронка продаж по карточкам за период и по дням, поисковые отчеты с позициями в выдаче и топ-запросами по товару, остатки по товарам, размерам и складам, и создание CSV-отчетов с проверкой статуса и скачиванием ZIP-архива в течение 48 часов. Все инструменты только читают данные, лимит самого API Wildberries три запроса в минуту. Сервер ставится через uv, запускается локально командой uv run main.py или в Docker.

Для кого. Для продавцов и аналитиков на Wildberries, которым нужна аналитика продаж и поисковой выдачи в разговорном виде.

Подходит, если

Нужно сравнить воронку продаж за разные периоды или по товарам
Нужны позиции товара в поисковой выдаче и топ-запросы, приводящие заказы
Нужны остатки по складам и размерам без захода в личный кабинет

Не подходит, если

Нужны операции с ценами, поставками или рекламными ставками: сервер их не дает
Не устраивает лимит API Wildberries в три запроса в минуту

Пример запроса к агенту

Сравни воронку продаж этого месяца с прошлым и покажи топ-20 запросов по товару 123456

Ограничения

Нужен токен продавца Wildberries с доступом к аналитике. Требуется Python 3.12 и менеджер пакетов uv. API Wildberries ограничивает аналитические запросы тремя в минуту, при большом числе карточек отчеты собираются медленно. Проект не публикует релиз в PyPI, ставится только из исходников.

Как отключить. Удалите сервер wildberries из конфигурации MCP клиента и остановите процесс или контейнер.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения
Переменные окружения
WILDBERRIES_TOKEN обязательная, секрет	Токен продавца из кабинета WB, раздел Доступ к API

Проверка безопасности

Все инструменты только читают аналитику, воронку, поиск и остатки, без изменения цен, ставок или заказов

Коротко о README

README дает быстрый старт в три шага, требования Python 3.12 и uv, примеры конфигурации для Cursor и Claude Desktop без Docker и с ним, список примеров запросов на обычном языке и справочник всех инструментов по четырем группам с указанием лимита API три запроса в минуту.

Частые вопросы

Может ли сервер менять цены или ставки?

Нет, все инструменты только читают аналитику, воронку, поиск и остатки.

Сколько ждать скачивания CSV-отчета?

Отчет создается заданием, статус проверяется отдельным инструментом, готовый ZIP доступен для скачивания 48 часов.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO

Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Claude SEO

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

Скиллы DataLens

MCP Яндекс Метрики со всеми 108 методами API

OpenSEO

Claude SEO