wildberries-api

Wildberries API MCP сервер предоставляет единый контролируемый интерфейс для доступа к данным аналитики, статистике продвижения и другим данным из Wildberries API. Он упрощает работу с различными эндпойнтами, обрабатывает ограничения по частоте запросов и нормализует форматы ответов, чтобы ваши скрипты и дашборды могли работать консистентно. В README описаны группы эндпоинтов: продвижение (adv/fullstats, stat-words, stats), воронка продаж (nm-report), поисковые запросы (search-report), остатки (stocks-report) и CSV-отчеты продавца. Вы можете отправлять запросы к нужным группам эндпойнтов, передавая параметры в формате JSON, и получать унифицированные ответы.

Для использования достаточно запустить MCP сервер и отправлять запросы к его API. Список доступных инструментов можно использовать как символьный интерфейс к реальным данным Wildberries: статистика рекламных кампаний, детализация карточек товаров по дням, отчеты по поисковым запросам и многое другое. В примерах указан способ вызова эндпоинтов через fetch или axios и содержание тела запроса, включая необходимость передачи вашего токена API Wildberries в заголовках (api-key) или через конфигурацию сервера.

prerequisites:

• Node.js версии 14 или выше
• npm или yarn
• Docker и Docker Compose (опционально)
• Wildberries API токен с соответствующими разрешениями

Способ 1: Прямая установка через Node.js

# Клонирование репозитория
git clone https://github.com/yourusername/wb-api-mcp-server.git
cd wb-api-mcp-server

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

# Запуск сервера
npm start

Сервер запустится на порту по умолчанию (3000). Вы можете изменить порт, установив переменную окружения PORT.

PORT=8080 npm start

Способ 2: Использование Docker

# Создание Docker-образа
docker build -t wb-api-mcp-server .

# Запуск Docker-контейнера
docker run -p 3000:3000 -d --name wb-api-mcp wb-api-mcp-server

Способ 3: Использование Docker Compose

# Запуск сервера с Docker Compose
docker-compose up -d

# Остановка сервера
docker-compose down

Проверка установки:

curl http://localhost:3000/health

Ожидаемый результат:

{
  "status": "ok",
  "timestamp": "<текущая-метка-времени>"
}

Примечание: адаптируйте команды под вашу конфигурацию окружения, особенно если вы используете другой путь к серверному файлу (server.js) или другой точку входа.

tips:

• Убедитесь, что ваш Wildberries API токен корректно настроен и имеет необходимые разрешения.
• При работе с частыми запросами используйте задержки или кэширование результатов, чтобы избежать превышения лимитов API.
• В конфигурации окружения можно задать PORT и другие параметры сервера, чтобы адаптировать MCP к вашей инфраструктуре.
• Для продакшн-окружения рекомендуется использовать Docker Compose или Kubernetes и настраивать секцию health checks.
• Если сервер возвращает ошибки, проверьте логи сервера на предмет проблем с токеном, форматом тела запроса или ограничениями API.