lyohadunker26/mcp-server-wildberries

MCP Server Wildberries

🚀 Полноценный Model Context Protocol (MCP) сервер для Wildberries API

Автоматизируйте работу с маркетплейсом Wildberries через Claude и другие AI-ассистенты, поддерживающие MCP.

🌟 Основные возможности

📦 Управление товарами (Content API)

• ✅ Создание и обновление карточек товаров
• ✅ Загрузка и управление медиафайлами
• ✅ Работа с характеристиками и размерами
• ✅ Управление остатками на складах
• ✅ Получение информации о товарах в карантине

🛒 Заказы и поставки (Marketplace API)

• ✅ Получение списка заказов FBS/DBS
• ✅ Работа со сборочными заданиями
• ✅ Создание и управление поставками
• ✅ Генерация стикеров и документов
• ✅ Обновление статусов заказов
• ✅ Получение пропусков на склады

💰 Цены и скидки (Prices API)

• ✅ Управление ценами товаров
• ✅ Настройка скидок и акций
• ✅ Работа с размерными сетками цен
• ✅ Мониторинг карантинных цен

📊 Статистика и аналитика (Statistics & Analytics API)

• ✅ Детализированная статистика продаж
• ✅ Аналитика по товарам и категориям
• ✅ Отчеты по эффективности
• ✅ История остатков и движений
• ✅ Воронка продаж

🎯 Продвижение и реклама (Promotion API)

• ✅ Управление рекламными кампаниями
• ✅ Ставки на продвижение товаров
• ✅ Календарь акций и участие
• ✅ Бюджеты и финансы рекламы

💬 Работа с покупателями

• ✅ Вопросы и отзывы покупателей
• ✅ Чат с покупателями
• ✅ Шаблоны ответов
• ✅ Обработка возвратов

📋 Отчеты и документы

• ✅ Отчеты по реализации
• ✅ Документооборот
• ✅ Финансовые отчеты
• ✅ Тарифы и комиссии

🚀 Быстрый старт

1. Установка

npm install -g @modelcontextprotocol/server-wildberries

2. Получение API токена

1. Войдите в личный кабинет Wildberries
2. Перейдите в Настройки → Доступ к API
3. Создайте новый токен с необходимыми категориями доступа:
   • Контент
   • Маркетплейс
   • Статистика
   • Цены и скидки
   • Продвижение
   • Аналитика
   • Вопросы и отзывы
   • Чат с покупателями
   • Поставки
   • Возвраты
   • Документы
   • Финансы

3. Настройка Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

Windows:

{
  "mcpServers": {
    "wildberries": {
      "command": "mcp-server-wildberries",
      "args": [],
      "env": {
        "WILDBERRIES_API_TOKEN": "ваш_токен_здесь"
      }
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "wildberries": {
      "command": "mcp-server-wildberries",
      "args": [],
      "env": {
        "WILDBERRIES_API_TOKEN": "ваш_токен_здесь"
      }
    }
  }
}

4. Перезапустите Claude Desktop

После добавления конфигурации полностью перезапустите Claude Desktop.

📖 Использование

После настройки вы можете использовать команды в Claude:

"Покажи все мои товары на Wildberries"
"Создай новую карточку товара"
"Получи статистику продаж за последний месяц"
"Обнови цены на товары"
"Покажи новые заказы"
"Создай поставку на склад"
"Ответь на отзывы покупателей"

🔧 Переменные окружения

🛠️ Разработка

Клонирование репозитория

git clone https://github.com/lyohadunker26/mcp-server-wildberries.git
cd mcp-server-wildberries

Установка зависимостей

npm install

Сборка

npm run build

Запуск в режиме разработки

npm run dev

Тестирование

npm test

📁 Структура проекта

src/
├── index.ts                 # Главный файл сервера
├── types/                   # TypeScript типы
│   ├── api.ts              # Типы API
│   └── common.ts           # Общие типы
├── services/               # Сервисы для работы с API
│   ├── content.ts          # Контент API
│   ├── marketplace.ts      # Маркетплейс API
│   ├── statistics.ts       # Статистика API
│   ├── prices.ts           # Цены и скидки API
│   ├── promotion.ts        # Продвижение API
│   ├── analytics.ts        # Аналитика API
│   ├── feedback.ts         # Отзывы API
│   ├── chat.ts            # Чат API
│   ├── supplies.ts        # Поставки API
│   ├── returns.ts         # Возвраты API
│   ├── documents.ts       # Документы API
│   └── finance.ts         # Финансы API
├── utils/                  # Утилиты
│   ├── http.ts            # HTTP клиент
│   ├── validation.ts      # Валидация данных
│   └── rate-limiter.ts    # Ограничение скорости запросов
└── handlers/              # Обработчики MCP команд
    ├── content.ts
    ├── marketplace.ts
    └── ...

🔒 Безопасность

• Храните токен в безопасности - не передавайте его третьим лицам
• Используйте переменные окружения - никогда не храните токен в коде
• Регулярно обновляйте токен - токены действуют 180 дней
• Следите за активностью - проверяйте логи использования API

📊 Лимиты API

Wildberries API имеет ограничения на количество запросов:

• Контент API: 10 запросов в 6 секунд
• Маркетплейс API: 300 запросов в минуту
• Статистика API: 10 запросов в 10 минут
• Общие методы: 3 запроса в 30 секунд

Сервер автоматически соблюдает эти лимиты.

🤝 Вклад в разработку

1. Форкните репозиторий
2. Создайте ветку для новой функции (git checkout -b feature/amazing-feature)
3. Зафиксируйте изменения (git commit -m 'Add amazing feature')
4. Отправьте в ветку (git push origin feature/amazing-feature)
5. Откройте Pull Request

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл .

🆘 Поддержка

• 📖 Документация Wildberries API
• 🐛 Сообщить об ошибке
• 💡 Предложить функцию

📈 Статус проекта

Сделано с ❤️ для автоматизации бизнеса на Wildberries