avito-mcp-ru

Однорыночная поставка ядра marketplaces-mcp-ru только под Авито: 64 метода API, каталог методов вместо сотни отдельных инструментов

MCP-серверРоссийский стек

ilyautov/avito-mcp-ruАвтор:Ilya Utov

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/avito-mcp-ru

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

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

Выполните в терминале

claude mcp add --transport stdio --env 'AVITO_CLIENT_ID=<ваш AVITO_CLIENT_ID>' --env 'AVITO_CLIENT_SECRET=<ваш AVITO_CLIENT_SECRET>' avito-mcp-ru -- uvx avito-mcp-ru==0.6.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"avito-mcp-ru","type":"stdio","command":"uvx","args":["avito-mcp-ru==0.6.0"],"env":{"AVITO_CLIENT_ID":"<ваш AVITO_CLIENT_ID>","AVITO_CLIENT_SECRET":"<ваш AVITO_CLIENT_SECRET>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "avito-mcp-ru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add avito-mcp-ru --env 'AVITO_CLIENT_ID=<ваш AVITO_CLIENT_ID>' --env 'AVITO_CLIENT_SECRET=<ваш AVITO_CLIENT_SECRET>' -- uvx avito-mcp-ru==0.6.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.avito-mcp-ru]
command = "uvx"
args = ["avito-mcp-ru==0.6.0"]
env = { AVITO_CLIENT_ID = "<ваш AVITO_CLIENT_ID>", AVITO_CLIENT_SECRET = "<ваш AVITO_CLIENT_SECRET>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'AVITO_CLIENT_ID=<ваш AVITO_CLIENT_ID>' -e 'AVITO_CLIENT_SECRET=<ваш AVITO_CLIENT_SECRET>' avito-mcp-ru uvx avito-mcp-ru==0.6.0

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "avito-mcp-ru": {
      "type": "local",
      "command": [
        "uvx",
        "avito-mcp-ru==0.6.0"
      ],
      "environment": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru==0.6.0"
      ],
      "env": {
        "AVITO_CLIENT_ID": "<ваш AVITO_CLIENT_ID>",
        "AVITO_CLIENT_SECRET": "<ваш AVITO_CLIENT_SECRET>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

AVITO_CLIENT_IDсекрет, обязательная: client_id из раздела Для бизнеса → Интеграции → API.
AVITO_CLIENT_SECRETсекрет, обязательная: client_secret оттуда же, меняется на токен по OAuth2.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит edf2d01.

Текст для агента

Запусти сервер командой uvx --from git+https://github.com/ilyautov/avito-mcp-ru avito-mcp-ru (после релиза короче: uvx avito-mcp-ru), укажи в конфигурации клиента переменные AVITO_CLIENT_ID и AVITO_CLIENT_SECRET из раздела Для бизнеса, Интеграции, API на avito.ru, либо попроси агента поставить все самостоятельно командой npx skills add ilyautov/avito-mcp-ru.

Другие способы из описания автора

uvx --from git+https://github.com/ilyautov/avito-mcp-ru avito-mcp-ru

До первого релиза на PyPI, после релиза команда короче: uvx avito-mcp-ru.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер поднимает один MCP для официального API Авито и ничего больше, ядро и каталог методов он получает зависимостью от проекта marketplaces-mcp-ru того же автора. Вместо отдельного инструмента на каждый метод агент ищет нужный по-русски или по-английски в каталоге из 64 методов (40 на чтение, 22 на запись, 2 необратимых) по темам мессенджер, автозагрузка, заказы и Авито Доставка, объявления и статистика, продвижение, рейтинг и отзывы, баланс, остатки. OAuth2 пара client_id и client_secret меняется на токен автоматически, ключи нескольких кабинетов можно хранить в ~/.marketplace-mcp/cabinets.json с правами 600 и переключаться между ними прямо в чате.

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

Подходит, если

Нужен только Авито без Wildberries, Ozon и Яндекс Маркета в одном сервере
Нужна работа с несколькими кабинетами Авито и переключением между ними
Нужны и чтение статистики, и операции вроде ответа в мессенджере или обновления остатков

Не подходит, если

Нужны сразу несколько маркетплейсов: тогда проще поставить marketplaces-mcp-ru тем же автором
Каталог еще не проверен на реальных кабинетах: README честно пишет, что живой прогон не проводился

Пример запроса к агенту

Покажи статистику по моим объявлениям на Авито за неделю и собери непрочитанные сообщения из мессенджера

Ограничения

Каталог методов собран из официальной документации Авито, но живой прогон на реальных кабинетах, по словам автора, еще не проводился, поэтому возможны расхождения в именах полей, которые правятся через describe_method и avito_get_raw. Доступ к разделам API, включая мессенджер и Авито Доставку, Авито выдает по заявке и не одинаков у всех аккаунтов. Токен OAuth2 живет ограниченное время, при обращении мимо сервера его нужно обновлять вручную.

Как отключить. Удалите сервер avito из конфигурации MCP-клиента и файл ~/.marketplace-mcp/cabinets.json с сохраненными кабинетами.

MCP

Транспорт: stdio
Авторизация: OAuth

Переменные окружения
Переменные окружения
AVITO_CLIENT_ID обязательная, секрет	client_id из раздела Для бизнеса, Интеграции, API на avito.ru.
AVITO_CLIENT_SECRET обязательная, секрет	client_secret оттуда же, меняется на access-токен по OAuth2.

Проверка безопасности

22 метода пишут данные, включая ответы в мессенджере и изменение остатков
Два метода необратимы, ключи OAuth2 нескольких кабинетов хранятся локально

Коротко о README

README дает три способа установки (uvx из git, uvx после релиза на PyPI, автопостановка навыком), объясняет получение пары client_id и client_secret на avito.ru и их обмен на токен, таблицу карты методов по темам с числом операций чтения, записи и необратимых, примеры вопросов в чат, раздел частых ошибок 401 и 403 и явное сравнение с пакетом marketplaces-mcp-ru того же автора.

Частые вопросы

Чем это отличается от marketplaces-mcp-ru?

Только составом: этот пакет ставит один сервер для Авито, а marketplaces-mcp-ru все четыре маркетплейса сразу, код общий.

Где хранятся ключи нескольких кабинетов?

В ~/.marketplace-mcp/cabinets.json с правами 600 вне репозитория, переключение между кабинетами доступно прямо в чате.

Salesforce DX MCP Server

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483

Скиллы Яндекс.Кит для управления магазином

kit-skills

Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28

YouGile MCP от Indalo

YouGile MCP

Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN

MCP-сервер портала Битрикс24

Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

Salesforce DX MCP Server

Скиллы Яндекс.Кит для управления магазином

YouGile MCP от Indalo

MCP-сервер портала Битрикс24