Marketplaces Mcp

---
name: marketplaces-mcp
description: "Подключить кабинеты Wildberries, Ozon, Яндекс Маркета и Авито к ИИ-ассистенту и работать с продажами, остатками, ценами и заказами прямо из чата. Ставит MCP-сервер marketplaces-mcp-ru: 1022 метода официальных Seller API, каталог ищется обычными словами, у каждого метода класс доступа, запись требует подтверждения. Используй, когда человек торгует на маркетплейсах и хочет собрать аналитику, свести остатки или автоматизировать кабинет. Триггеры: «подключи маркетплейсы», «api маркетплейсов», «api wildberries», «api ozon», «авито api», «api яндекс маркет», «выгрузи продажи с вб», «остатки на озоне», «сведи остатки по маркетплейсам», «marketplace mcp»."
---

# Маркетплейсы через MCP

Ставит сервер `marketplaces-mcp-ru`: 1022 метода официальных Seller API в одном
каталоге.

| маркетплейс | методов | префикс инструментов |
|---|---:|---|
| Ozon Seller | 441 | `ozon_` |
| Wildberries | 307 | `wb_` |
| Яндекс Маркет | 165 | `ym_` |
| Авито | 64 | `avito_` |
| Ozon Performance (реклама) | 45 | `ozon_perf_` |

Каталог лежит в YAML и исполняется сервером, поэтому агент получает несколько
универсальных инструментов на маркетплейс, а не по отдельной функции на каждый
метод.

## Установка

```bash
uvx marketplaces-mcp-ru
```

Конфигурация клиента (Claude Desktop, Cursor, Claude Code):

```json
{
  "mcpServers": {
    "marketplaces-ru": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<токен Wildberries, необязательно>",
        "OZON_CLIENT_ID": "<client id Ozon, необязательно>",
        "OZON_API_KEY": "<api key Ozon, необязательно>",
        "YANDEX_MARKET_API_KEY": "<ключ Яндекс Маркета, необязательно>",
        "AVITO_CLIENT_ID": "<client id Авито, необязательно>",
        "AVITO_CLIENT_SECRET": "<client secret Авито, необязательно>"
      }
    }
  }
}
```

Переменные тех маркетплейсов, на которых человек не торгует, просто не
указываются: сервер поднимется и будет работать с остальными.

## Где взять ключи

- Wildberries: `seller.wildberries.ru`, Настройки → Доступ к API.
- Ozon: `seller.ozon.ru`, Настройки → API-ключи, нужны обе половины пары.
- Яндекс Маркет: `partner.market.yandex.ru`, Настройки → API.
- Авито: Для бизнеса → Интеграции → API, пара меняется на токен по OAuth2.

Второй путь, без переменных окружения: поднять сервер и вызвать
`<префикс>_add_cabinet`. Ключи лягут в `~/.marketplace-mcp/cabinets.json` с
правами 600 и с машины не уходят. Так же подключается второй магазин.

## Что спрашивать у сервера

- `wb_search_methods("остатки по складам")`: поиск метода словами.
- `ozon_describe_method(...)`: параметры, пагинация, класс доступа.
- `ym_call_method(...)`: вызов. Чтение идёт сразу, запись просит подтверждения,
  необратимое просит дважды.
- `avito_check_auth`: проверить, что ключи дошли.

## Как себя вести

Сначала ищи метод каталогом, не угадывай имя. Перед записью покажи человеку,
что именно уйдёт в API, и дождись согласия: гейт сработает всё равно, но
человек должен увидеть тело запроса до, а не после.

Числа из ответа не округляй и не пересчитывай в уме. Если метод вернул пустой
список, так и скажи, вместо того чтобы объяснять это за продавца.

Сводя данные по нескольким маркетплейсам, держи источник у каждой строки:
у площадок разные определения продажи, заказа и возврата, и молчаливое
суммирование даёт красивое неверное число.

## Только один маркетплейс

Если нужен ровно один кабинет, есть отдельные пакеты с тем же каталогом:
`ozon-mcp-ru`, `wildberries-mcp-ru`, `yandex-market-mcp-ru`, `avito-mcp-ru`.