MCP-сервер для Claude

mpstats-mcp — MCP-сервер, предоставляющий Claude доступ к аналитике маркетплейсов через MPStats API.

Что это даёт

Вместо написания кода, Claude может напрямую:

• Анализировать товары и категории WB/Ozon
• Проверять позиции и ключевые слова
• Считать продажи и выручку
• Проводить аудит карточек товаров
• Мониторить конкурентов

Установка

Требования

• Python 3.10+
• uv (менеджер пакетов)
• Токен MPStats API

Шаг 1: Клонирование

git clone https://github.com/nofearmatt/mpstats-mcp.git
cd mpstats-mcp

Шаг 2: Установка зависимостей

uv sync

Шаг 3: Настройка токена

Создайте файл .env:

MPSTATS_TOKEN=your_token_here

Шаг 4: Подключение к Claude

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "mpstats": {
      "command": "uv",
      "args": ["--directory", "/path/to/mpstats-mcp", "run", "mpstats-mcp"],
      "env": {
        "MPSTATS_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Code

Добавьте в .mcp.json проекта:

{
  "mcpServers": {
    "mpstats": {
      "command": "uv",
      "args": ["--directory", "/path/to/mpstats-mcp", "run", "mpstats-mcp"],
      "env": {
        "MPSTATS_TOKEN": "your_token_here"
      }
    }
  }
}

12 инструментов

Служебные

Инструмент	Описание	Статус
mpstats_check_limits	Проверка квот API	✅

Wildberries — Категории

Инструмент	Описание	Статус
mpstats_wb_category_products	Товары в категории (топ по выручке, продажам)	✅
mpstats_wb_category_trends	Тренды категории (до 72 мес.)	✅

Wildberries — SKU-аналитика

Инструмент	Описание	Статус
mpstats_wb_sku_sales	Продажи по дням	✅
mpstats_wb_sku_keywords	Ключевые слова и позиции	✅
mpstats_wb_sku_positions	Позиции в категориях	✅
mpstats_wb_sku_reviews	Отзывы	✅

Wildberries — Бренды и продавцы

Инструмент	Описание	Статус
mpstats_wb_brand_products	Товары бренда	❌ (тариф)
mpstats_wb_seller_products	Товары продавца	❌ (тариф)

Ozon

Инструмент	Описание	Статус
mpstats_oz_category_products	Товары в категории Ozon	⚠️
mpstats_oz_sku_sales	Продажи SKU на Ozon	⚠️

Универсальный

Инструмент	Описание	Статус
mpstats_raw_request	Произвольный запрос к любому из 125 эндпоинтов	✅

Примеры использования в Claude

Анализ категории

"Покажи топ-10 товаров в категории Автотовары на WB по выручке за последний месяц"

Claude вызовет mpstats_wb_category_products и покажет таблицу с товарами.

Аудит карточки

"Проанализируй товар 143207180 на WB: продажи, ключевые слова, позиции"

Claude последовательно вызовет:

1. mpstats_wb_sku_sales — продажи за 30 дней
2. mpstats_wb_sku_keywords — по каким словам находят
3. mpstats_wb_sku_positions — позиции в категориях

Конкурентный анализ

"Сравни продажи двух SKU: 143207180 и 98765432"

Claude вызовет mpstats_wb_sku_sales для каждого SKU и сравнит результаты.

Проверка квот

"Сколько API-запросов осталось?"

Claude вызовет mpstats_check_limits и покажет оставшиеся квоты.

Произвольный запрос

"Запроси остатки товара 143207180 по регионам"

Claude вызовет mpstats_raw_request с параметрами:

{
  "method": "GET",
  "endpoint": "wb/get/item/143207180/balance/by-region",
  "params": {"d1": "2026-02-01", "d2": "2026-02-19"}
}

Ограничения

• Бренды и продавцы: эндпоинты /brand и /seller требуют расширенный тариф (HTTP 500)
• Ozon: возвращает пустые ответы (требует отдельный модуль или другие пути)
• Усечение ответов: ответы > 50KB усекаются для экономии контекста Claude
• Квоты: 60 000 запросов/месяц (30K общих + по 10K на маркетплейс)

Исходный код

• Репозиторий: github.com/nofearmatt/mpstats-mcp
• Клиент: src/mpstats_mcp/client.py — async HTTP-клиент с 17 методами
• Сервер: src/mpstats_mcp/server.py — MCP-сервер с 12 инструментами
• Тесты: test_api.py — 10 интеграционных тестов (8 проходят)