English Français العربية

Авито MCP (RU)

Official registry Other

API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package avito-mcp-ru
Claude Code 
claude mcp add mcp-ru -e 'AVITO_CLIENT_ID=<your avito_client_id>' -e 'AVITO_CLIENT_SECRET=<your avito_client_secret>' -- uvx avito-mcp-ru==0.6.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-ru": {
            "command": "uvx",
            "args": [
                "avito-mcp-ru==0.6.0"
            ],
            "env": {
                "AVITO_CLIENT_ID": "<your avito_client_id>",
                "AVITO_CLIENT_SECRET": "<your avito_client_secret>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. avito-mcp-ru
  2. Установка
  3. Ключи
  4. Карта методов
  5. Что спросить в чате
  6. Частые ошибки
  7. Чем это отличается от marketplaces-mcp-ru
  8. Кто это сделал
  9. Лицензия

avito-mcp-ru

API Авито для ИИ-ассистентов: объявления и статистика, чаты с покупателями, заказы и Авито Доставка, автозагрузка, продвижение, отзывы. Каталог исполняется сервером.

Пакет поднимает один сервер, Авито, и ничего больше. Сервер, каталог и ядро приходят зависимостью из marketplaces-mcp-ru: здесь имя, точка входа и документация под один маркетплейс.

Установка

Первый релиз на PyPI выпускается тегом v0.5.3, до этого пакет ставится прямо из репозитория:

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

После релиза строка короче:

uvx avito-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "avito": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ilyautov/avito-mcp-ru", "avito-mcp-ru"],
      "env": { "AVITO_CLIENT_ID": "...", "AVITO_CLIENT_SECRET": "..." }
    }
  }
}

Третий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.

npx skills add ilyautov/avito-mcp-ru

Ключи

Где взять пару. На avito.ru: Для бизнеса, раздел Интеграции, пункт API. Там выдаётся client_id и client_secret. Хост запросов api.avito.ru.

Как это превращается в токен. Пара меняется на access-токен по OAuth2, срок жизни ограничен. Сервер обновляет токен сам, вручную ничего перевыпускать не нужно.

Где всё лежит. В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально.

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

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.marketplace-mcp/cabinets.json с правами 600, вне репозитория. Магазинов подключается сколько нужно, переключение прямо из чата.

Карта методов

Каталог лежит в зависимости как avito_mcp/endpoints.yaml: 64 метода, из них 40 на чтение, 22 на запись и 2 необратимых. Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.

темаметодовчтениезаписьнеобратимые
Мессенджер (чаты с покупателями)13571
Автозагрузка (выгрузка объявлений файлом)121020
Заказы и Авито Доставка12660
Объявления и статистика11740
Продвижение объявлений (реклама)7610
Рейтинг и отзывы4211
Пользователь, баланс и операции3300
Остатки в объявлениях2110

Подробный разбор с параметрами и лимитами: https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html

Что спросить в чате

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

Частые ошибки

401 после того, как всё работало. Токен Авито живёт ограниченное время. Если запрос идёт мимо сервера, своим кодом, токен надо обновлять; через сервер это происходит само.

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

Ошибка в имени поля. Каталог собран из официальных документов, живой прогон на реальных кабинетах ещё не делался. describe_method покажет схему, avito_get_raw даст поправить запрос на месте.

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

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

нужнопакет
только Авитоavito-mcp-ru
все четыре маркетплейсаmarketplaces-mcp-ru

Кто это сделал

Илья Утов, лаборатория AI Frontier. Как эти инструменты устроены внутри, пишу в Telegram и LinkedIn.

Рядом стоят **business-mcp-ru** (hh.ru, VK, Диадок, СБИС, Честный знак), **moysklad-mcp-ru** и **humanizer-ru**.

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Лицензия

MIT, см. LICENSE.

Frequently asked questions

What is Авито MCP (RU)?

API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы

How do I install Авито MCP (RU)?

It runs on your machine. In Claude Code: claude mcp add mcp-ru -e 'AVITO_CLIENT_ID=<your avito_client_id>' -e 'AVITO_CLIENT_SECRET=<your avito_client_secret>' -- uvx avito-mcp-ru==0.6.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Авито MCP (RU) need an API key?

Yes. It expects AVITO_CLIENT_ID, AVITO_CLIENT_SECRET, which you set in its configuration.

Is Авито MCP (RU) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Авито MCP (RU)?

It is published by ilyautov. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.