ilyautov/marketplaces-mcp-ru/marketplaces-mcp

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

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

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

Установка

uvx marketplaces-mcp-ru

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

{
  "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.