MCP для Wildberries, Ozon и Яндекс Маркета
marketplace-mcp
MCP-сервер с типизированным чтением кабинетов Wildberries, Ozon и Яндекс Маркета: одна схема ответа на три площадки, мультиаккаунты, лимиты и аудит
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает приватные данные продавца: остатки, цены и заказы трех кабинетов
- Версия v0.3 не пишет данные, но ключи хранятся на сервере, стоит держать MCP_AUTH_TOKEN и TLS-прокси перед продакшн-инстансом
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/marketplace-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio marketplace -- npx tsx /path/to/marketplace-mcp/src/index.tsИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"marketplace","type":"stdio","command":"npx","args":["tsx","/path/to/marketplace-mcp/src/index.ts"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"marketplace": {
"type": "stdio",
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add marketplace -- npx tsx /path/to/marketplace-mcp/src/index.tsИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.marketplace]
command = "npx"
args = ["tsx", "/path/to/marketplace-mcp/src/index.ts"]Если файл уже есть, допишите блок в конец.
Выполните в терминале
gemini mcp add -s user marketplace npx tsx /path/to/marketplace-mcp/src/index.tsИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"marketplace": {
"type": "local",
"command": [
"npx",
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": [
"tsx",
"/path/to/marketplace-mcp/src/index.ts"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Склонируй bssoft2b/marketplace-mcp, выполни npm install и npm run dev для демо-режима без ключей или задай WB_API_TOKEN, OZON_CLIENT_ID, OZON_API_KEY, YM_API_KEY для реальных кабинетов, затем подключи через claude mcp add marketplace -- npx tsx /путь/к/marketplace-mcp/src/index.ts.
Другие способы из описания автора
claude mcp add marketplace -- npx tsx /path/to/marketplace-mcp/src/index.tsДемо-режим stdio без ключей, после npm install и npm run dev.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к личным кабинетам продавца на трех площадках и приводит их несовместимые модели товаров, остатков и заказов к единой нормализованной схеме на zod, так что агент задает один вопрос и получает один формат ответа по всем подключенным аккаунтам. Версия v0.3 закрывает только чтение: 17 инструментов, из них 12 инструментов данных с проверкой outputSchema. Учетные данные хранятся зашифрованными AES-256-GCM в PostgreSQL либо передаются переменными окружения в демо-режиме с мок-данными без ключей. У каждой площадки свой лимитер запросов, единая модель ошибок с кодом retryable и журнал вызовов инструментов.
Для кого. Для продавцов на нескольких маркетплейсах, которым нужен единый взгляд на остатки, цены и заказы без ручного сравнения трех личных кабинетов.
Подходит, если
- Нужно сравнить остатки, цены или заказы по одному товару сразу на трех площадках
- Нужен один нормализованный формат данных вместо трех разных API
- Нужна демонстрация без реальных ключей: сервер запускается с мок-данными
Не подходит, если
- Нужно менять цены, остатки или статусы заказов: версия v0.3 только читает данные
- Нужна работа с рекламой или финансовой отчетностью площадок: в роадмапе, но не реализовано
- Нужен единый продакшн-контур без своей PostgreSQL: без базы сервер держит только демо-режим
Пример запроса к агенту
Проверь на Wildberries, Ozon и Яндекс Маркете, каких товаров осталось меньше десяти штукОграничения
Функциональность ограничена чтением, запись с подтверждением и история изменений остатков в планах, но не сделаны. Контракт Ozon собран по документации и клиентам сообщества, так как официальной OpenAPI-спецификации Ozon не публикует, и автор прямо называет это самым слабым местом. У Яндекс Маркета нет отдельной тестовой среды, только тестовые заказы внутри боевого кабинета. Для продакшена нужны собственные PostgreSQL и обратный прокси с TLS перед /mcp.
Как отключить. Остановите контейнеры docker compose down или удалите сервер marketplace из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WB_API_TOKEN секрет | Токен продавца Wildberries из кабинета, раздел API |
| OZON_CLIENT_ID секрет | Client-Id продавца Ozon для Seller API |
| OZON_API_KEY секрет | Api-Key продавца Ozon для Seller API |
| YM_API_KEY секрет | Ключ Партнерского API Яндекс Маркета |
| MCP_AUTH_TOKEN секрет | Bearer-токен для защиты HTTP-транспорта в продакшн-режиме |
Проверка безопасности
- Читает приватные данные продавца: остатки, цены и заказы трех кабинетов
- Версия v0.3 не пишет данные, но ключи хранятся на сервере, стоит держать MCP_AUTH_TOKEN и TLS-прокси перед продакшн-инстансом
Коротко о README
README объясняет, зачем нужна единая схема поверх трех несовместимых API, приводит пример вывода npm test с объединением остатков трех аккаунтов, дает быстрый старт без ключей и с реальными токенами, таблицу способов авторизации и тестовых сред каждой площадки, список из 17 инструментов, архитектуру адаптеров и заметки о проверке путей и лимитов API по официальным спецификациям на 28 августа 2026 года. Отдельно описана защита транспорта: bearer-токен, проверка Origin и привязка к 127.0.0.1 без MCP_AUTH_TOKEN.
Частые вопросы
Можно попробовать без реальных ключей продавца?
Да, без DATABASE_URL сервер запускается с мок-данными по всем трем площадкам и не требует токенов.
Может ли сервер поменять цену или остаток?
Нет, в версии v0.3 реализовано только чтение, запись с подтверждением заявлена в роадмапе.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма