Авито MCP (RU)

io.github.ilyautovPublished by GitHub account ilyautovv0.6.0Updated Oct 25, 2026

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

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Local MCP server that connects an AI assistant to the Avito marketplace API for listings, chats, orders, autoload, promotion and reviews.

What you can do
Read and manage listings and their statistics, including stock levels and promotion campaigns for ads (64 methods in total, 40 read, 22 write, 2 irreversible). Work with buyer chats in the messenger: read, reply and manage conversations. Handle Avito Delivery orders and autoload of listings from files. View ratings and reviews, plus user profile, balance and transactions. Inspect method schemas and send raw requests to correct calls on the spot.
When to use it
Useful for Avito business sellers who want an assistant to check listing statistics, gather unread buyer messages, track delivery orders or update stock without leaving the chat. Choose it when only Avito is needed; a separate package covers several marketplaces at once.
Requirements
Runs locally via uvx (Python package avito-mcp-ru), configured in the desktop client. Requires an Avito business account with API access and the AVITO_CLIENT_ID and AVITO_CLIENT_SECRET credentials, which are exchanged for an OAuth2 token automatically. Network access to api.avito.ru. Cabinets can be stored locally in a config file with restricted permissions.
Before you install
Requires the secret AVITO_CLIENT_ID and AVITO_CLIENT_SECRET; the server stores cabinets in a local config file. Many methods write data (22 of 64) and two are irreversible, so changes to listings, chats, orders or stock should be reviewed before running. Avito grants API section access per request, so messenger and delivery may be unavailable. The method catalog has not been tested against live accounts, so field errors are possible.

Installation

In SourceWeft

  1. Open Авито MCP (RU) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

avito-mcp-ru

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

[PyPI] [CI] [License: MIT] [Методов] [Сайт] [Звёзды]

[avito-mcp-ru: API Авито в ИИ-ассистенте. 64 метода]

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

Установка

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

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

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

bash
uvx avito-mcp-ru

Claude Desktop, claude_desktop_config.json:

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": "..." }    }  }}

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

bash
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.

Source: README.md at commit edf2d01

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts