MPStats MCP: аналитика маркетплейсов MPSTATS для агента

snsudak/mpstats-mcp· Проверено 12.11.2026· 0на GitHub

Даёт агенту аналитику MPSTATS по токену API: категории, бренды, продавцы, продажи и остатки товаров Wildberries, Ozon и Яндекс Маркета. Сравнить периоды и найти товары с риском закончиться.

2 реализации:

Сервер на Python по HTTP: его разворачивают на своём хосте и подключают к claude.ai как кастомный коннектор, тогда он работает во всех чатах, включая мобильное приложение; Wildberries, Ozon и Яндекс Маркет.

Как подключить

Что сделать до подключения

Свой сервер с Docker: в репозитории есть Dockerfile, контейнер слушает порт 8000

Задать на сервере MPSTATS_TOKEN и секретный путь MCP_PATH вида /s/<случайная строка>/mcp

Для пробы на своём компьютере: pip install "fastmcp>=2.12,<3" "httpx>=0.27" "uvicorn>=0.30", затем python server.py

MPSTATS_TOKEN

mpstats.io/userpanel → блок «API token»

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http mpstats https://<ваш хост>/s/<секретная строка>/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mpstats]
url = "https://<ваш хост>/s/<секретная строка>/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mpstats": {
      "url": "https://<ваш хост>/s/<секретная строка>/mcp"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mpstats": {
      "type": "http",
      "url": "https://<ваш хост>/s/<секретная строка>/mcp"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mpstats": {
      "httpUrl": "https://<ваш хост>/s/<секретная строка>/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mpstats": {
      "httpUrl": "https://<ваш хост>/s/<секретная строка>/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mpstats": {
        "type": "remote",
        "url": "https://<ваш хост>/s/<секретная строка>/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://<ваш хост>/s/<секретная строка>/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mpstats": {
      "url": "https://<ваш хост>/s/<секретная строка>/mcp"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

mpstats_api_limitпоказывает остаток лимита запросов

mpstats_categoriesищет категорию в дереве

mpstats_categoryвыдаёт товары, бренды и тренды категории

mpstats_brandвыдаёт аналитику бренда

mpstats_sellerвыдаёт аналитику продавца

mpstats_skuчитает продажи, остатки и отзывы товара

mpstats_subjectразбирает нишу Wildberries

mpstats_similarнаходит похожие товары WB

mpstats_compareсравнивает два периода

mpstats_forecastдаёт прогноз и сезонность WB

mpstats_requestвызывает любой метод API

Локальный сервер на Node.js: готовые отчёты по Wildberries — риск остатков, видимость в поиске, низкий выкуп, упущенная выручка — и базовая аналитика категорий Ozon.

Как подключить

Что сделать до подключения

Node.js и pnpm

Склонировать репозиторий и выполнить pnpm install и pnpm build

Токен можно положить в .env или .env.local в корне репозитория: сервер читает их сам

MPSTATS_TOKEN

токен API из личного кабинета MPSTATS

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MPSTATS_TOKEN=<токен MPSTATS>' --transport stdio mpstats-mcp \
  -- node '<путь к mpstats-mcp>/apps/mcp-server/dist/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mpstats-mcp]
command = "node"
args = ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"]

[mcp_servers.mpstats-mcp.env]
MPSTATS_TOKEN = "<токен MPSTATS>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mpstats-mcp": {
      "command": "node",
      "args": ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
      "env": {
        "MPSTATS_TOKEN": "<токен MPSTATS>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mpstats-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
      "env": {
        "MPSTATS_TOKEN": "<токен MPSTATS>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mpstats-mcp": {
      "command": "node",
      "args": ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
      "env": {
        "MPSTATS_TOKEN": "<токен MPSTATS>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mpstats-mcp": {
      "command": "node",
      "args": ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
      "env": {
        "MPSTATS_TOKEN": "<токен MPSTATS>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mpstats-mcp": {
        "type": "local",
        "command": ["node", "<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
        "environment": {
          "MPSTATS_TOKEN": "<токен MPSTATS>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mpstats-mcp": {
      "command": "node",
      "args": ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
      "env": {
        "MPSTATS_TOKEN": "<токен MPSTATS>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mpstats-mcp": {
      "command": "node",
      "args": ["<путь к mpstats-mcp>/apps/mcp-server/dist/index.js"],
      "env": {
        "MPSTATS_TOKEN": "<токен MPSTATS>"
      }
    }
  }
}

Инструменты сервера

mpstats_wb_get_item_detailsчитает карточку товара WB

mpstats_wb_get_sku_salesпоказывает продажи товара WB

mpstats_wb_get_item_stock_riskоценивает риск закончиться

mpstats_wb_get_keyword_opportunitiesподбирает запросы для товара

mpstats_wb_get_item_visibility_snapshotпоказывает видимость в поиске

mpstats_wb_get_slow_stock_watchlistищет залежавшиеся остатки

mpstats_wb_get_buyout_watchlistищет товары с низким выкупом

mpstats_wb_get_restock_opportunitiesищет упущенную выручку

mpstats_wb_get_top_brandsвыдаёт топ брендов категории

mpstats_wb_get_top_sellersвыдаёт топ продавцов

mpstats_wb_get_category_reportстроит отчёт по категории WB

mpstats_oz_get_category_reportстроит отчёт по категории Ozon

mpstats_oz_get_sku_salesпоказывает продажи товара Ozon

mpstats_oz_get_top_brandsвыдаёт топ брендов Ozon

Показано 14 из 27.

Что попросить агента

«Найди в MPSTATS категорию «<категория>» на Wildberries и покажи топ брендов и ценовые сегменты»snsudak найдёт путь через mpstats_categories и разберёт категорию через mpstats_category

«Покажи продажи и остатки по складам для товара <артикул>»snsudak вызовет mpstats_sku; у ebceu4 — mpstats_wb_get_sku_sales

«Сравни продажи бренда <бренд> за этот и прошлый месяц»snsudak вызовет mpstats_compare

«Какие товары в категории <категория> на WB скоро закончатся?»ebceu4 вызовет mpstats_wb_get_restock_opportunities и mpstats_wb_get_item_stock_risk

«Сколько запросов к API у меня осталось?»snsudak вызовет mpstats_api_limit

Для каких задач

Разобрать категорию маркетплейса: товары, бренды, продавцы, ценовые сегменты

Посмотреть продажи и остатки конкретного товара по складам и размерам

Сравнить два периода по категории, бренду или продавцу

Найти на Wildberries товары с риском закончиться и с низким выкупом

Подобрать поисковые запросы для товара Wildberries

Ограничения

Оба репозитория без звёзд на GitHub; ebceu4 последний раз обновлялся в апреле 2026 года

Нужен токен MPSTATS, число запросов ограничено тарифом; списки в отчётах — не больше 500 строк за страницу

snsudak защищён только секретной строкой в адресе: кто знает адрес, тот получает доступ, публиковать его нельзя

У ebceu4 Ozon пока в базовом объёме: метод продавцов Ozon отвечал ошибкой 500

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mpstats-mcp (snsudak)	snsudak	0	HTTP	не нужен	11	12 сентября 2026
mpstats-mcp (ebceu4)	ebceu4	0	локально	токен	27	24 апреля 2026

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

Где взять токен MPSTATS?

В личном кабинете mpstats.io/userpanel, блок «API token». Токен задаётся в переменной MPSTATS_TOKEN.

Можно ли пользоваться с телефона?

Да, через snsudak: разверните его на своём сервере с HTTPS и добавьте в Claude в Настройки → Connectors → Add custom connector адрес https://<хост>/s/<секрет>/mcp. Коннектор работает во всех чатах, включая мобильное приложение.

Какой вариант выбрать?

snsudak покрывает Wildberries, Ozon и Яндекс Маркет и даёт сырой вызов любого метода API, но его нужно разворачивать по HTTP. ebceu4 запускается локально и даёт готовые отчёты по Wildberries: остатки, выкуп, видимость, упущенная выручка.

Сколько данных возвращает сервер?

У snsudak ответ обрезается по MAX_RESPONSE_CHARS, по умолчанию 60 000 знаков, дерево категорий кешируется на 6 часов.

Как подключить MPStats MCP к Codex?

Для ebceu4 добавьте в ~/.codex/config.toml раздел [mcp_servers.mpstats] с command = "node" и путём к apps/mcp-server/dist/index.js. Если в корне репозитория есть .env с токеном, отдельный env не нужен.

Работает ли сервер из России?

Серверы обращаются к API mpstats.io по вашему токену, зарубежные аккаунты не нужны; вариант snsudak нужно развернуть на своём хосте с HTTPS.

MPStats MCP: аналитика маркетплейсов MPSTATS для агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

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

Похожие серверы