Авито MCP (RU)
API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
avito-mcp-ruclaude 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{
"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>"
}
}
}
}Variables d'environnement
AVITO_CLIENT_IDobligatoire secret client_id из раздела Для бизнеса → Интеграции → API.AVITO_CLIENT_SECRETobligatoire secret client_secret оттуда же, меняется на токен по OAuth2.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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-ruClaude 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 необратимых.
Сервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.
| тема | методов | чтение | запись | необратимые |
|---|---|---|---|---|
| Мессенджер (чаты с покупателями) | 13 | 5 | 7 | 1 |
| Автозагрузка (выгрузка объявлений файлом) | 12 | 10 | 2 | 0 |
| Заказы и Авито Доставка | 12 | 6 | 6 | 0 |
| Объявления и статистика | 11 | 7 | 4 | 0 |
| Продвижение объявлений (реклама) | 7 | 6 | 1 | 0 |
| Рейтинг и отзывы | 4 | 2 | 1 | 1 |
| Пользователь, баланс и операции | 3 | 3 | 0 | 0 |
| Остатки в объявлениях | 2 | 1 | 1 | 0 |
Подробный разбор с параметрами и лимитами: 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.
Questions fréquentes
Qu'est-ce que Авито MCP (RU) ?
API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы
Comment installer Авито MCP (RU) ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Авито MCP (RU) ?
Oui. Il attend AVITO_CLIENT_ID, AVITO_CLIENT_SECRET, à renseigner dans sa configuration.
Авито MCP (RU) est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Авито MCP (RU) ?
Il est publié par ilyautov. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.