{
  "markdown": "# avito-mcp-ru\n\n<!-- mcp-name: io.github.ilyautov/avito-mcp-ru -->\n\nAPI Авито для ИИ-ассистентов: объявления и статистика, чаты с покупателями, заказы и Авито Доставка, автозагрузка, продвижение, отзывы. Каталог исполняется сервером.\n\n[![PyPI](https://img.shields.io/pypi/v/avito-mcp-ru?label=pypi&color=B5491F)](https://pypi.org/project/avito-mcp-ru/)\n[![CI](https://github.com/ilyautov/avito-mcp-ru/actions/workflows/ci.yml/badge.svg)](https://github.com/ilyautov/avito-mcp-ru/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Методов](https://img.shields.io/badge/метода-64-2D7D4F)](#карта-методов)\n[![Сайт](https://img.shields.io/badge/%D1%81%D0%B0%D0%B9%D1%82-marketplaces--mcp--ru-9A3E1A)](https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html)\n[![Звёзды](https://img.shields.io/github/stars/ilyautov/avito-mcp-ru?style=flat&label=%D0%B7%D0%B2%D1%91%D0%B7%D0%B4%D1%8B&color=B5491F&logo=github&logoColor=white)](https://github.com/ilyautov/avito-mcp-ru/stargazers)\n\n<p align=\"center\">\n  <a href=\"https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html\">\n    <img src=\"assets/social-preview.png\" alt=\"avito-mcp-ru: API Авито в ИИ-ассистенте. 64 метода\" width=\"760\">\n  </a>\n</p>\n\nПакет поднимает один сервер, Авито, и ничего больше. Сервер, каталог и\nядро приходят зависимостью из [`marketplaces-mcp-ru`](https://github.com/ilyautov/marketplaces-mcp-ru):\nздесь имя, точка входа и документация под один маркетплейс.\n\n## Установка\n\nПервый релиз на PyPI выпускается тегом `v0.5.3`, до этого пакет ставится прямо из репозитория:\n\n```bash\nuvx --from git+https://github.com/ilyautov/avito-mcp-ru avito-mcp-ru\n```\n\nПосле релиза строка короче:\n\n```bash\nuvx avito-mcp-ru\n```\n\nClaude Desktop, `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"avito\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"git+https://github.com/ilyautov/avito-mcp-ru\", \"avito-mcp-ru\"],\n      \"env\": { \"AVITO_CLIENT_ID\": \"...\", \"AVITO_CLIENT_SECRET\": \"...\" }\n    }\n  }\n}\n```\n\nТретий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.\n\n```bash\nnpx skills add ilyautov/avito-mcp-ru\n```\n\n## Ключи\n\n**Где взять пару.** На `avito.ru`: **Для бизнеса**, раздел **Интеграции**, пункт **API**. Там выдаётся `client_id` и `client_secret`. Хост запросов `api.avito.ru`.\n\n**Как это превращается в токен.** Пара меняется на access-токен по OAuth2, срок жизни ограничен. Сервер обновляет токен сам, вручную ничего перевыпускать не нужно.\n\n**Где всё лежит.** В `~/.marketplace-mcp/cabinets.json` с правами `chmod 600`, локально.\n\n| переменная | секрет | что это |\n|---|---|---|\n| `AVITO_CLIENT_ID` | да | client_id из раздела Для бизнеса → Интеграции → API. |\n| `AVITO_CLIENT_SECRET` | да | client_secret оттуда же, меняется на токен по OAuth2. |\n\nКлючи можно не держать в окружении: сервер умеет кабинеты и кладёт их в\n`~/.marketplace-mcp/cabinets.json` с правами 600, вне репозитория. Магазинов\nподключается сколько нужно, переключение прямо из чата.\n\n## Карта методов\n\nКаталог лежит в зависимости как `avito_mcp/endpoints.yaml`:\n**64 метода**, из них 40 на чтение, 22 на запись и 2 необратимых.\nСервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.\n\n| тема | методов | чтение | запись | необратимые |\n|---|---:|---:|---:|---:|\n| Мессенджер (чаты с покупателями) | 13 | 5 | 7 | 1 |\n| Автозагрузка (выгрузка объявлений файлом) | 12 | 10 | 2 | 0 |\n| Заказы и Авито Доставка | 12 | 6 | 6 | 0 |\n| Объявления и статистика | 11 | 7 | 4 | 0 |\n| Продвижение объявлений (реклама) | 7 | 6 | 1 | 0 |\n| Рейтинг и отзывы | 4 | 2 | 1 | 1 |\n| Пользователь, баланс и операции | 3 | 3 | 0 | 0 |\n| Остатки в объявлениях | 2 | 1 | 1 | 0 |\n\nПодробный разбор с параметрами и лимитами: [https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html](https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html)\n\n## Что спросить в чате\n\n- покажи статистику по объявлениям за неделю\n- какие заказы Авито Доставки в работе\n- собери непрочитанные сообщения из мессенджера\n- обнови остатки по объявлениям\n\n## Частые ошибки\n\n**401 после того, как всё работало.** Токен Авито живёт ограниченное время. Если запрос идёт мимо сервера, своим кодом, токен надо обновлять; через сервер это происходит само.\n\n**403 на методе, который есть в документации.** У Авито доступ к разделам выдаётся по заявке и не одинаков у всех аккаунтов. Мессенджер и Авито Доставка открываются не каждому бизнесу.\n\n**Ошибка в имени поля.** Каталог собран из официальных документов, живой прогон на реальных кабинетах ещё не делался. `describe_method` покажет схему, `call_raw` даст поправить запрос на месте.\n\n## Чем это отличается от marketplaces-mcp-ru\n\nНичем, кроме состава. `marketplaces-mcp-ru` ставит четыре маркетплейса сразу и держит их\nпод одним сервером, `avito-mcp-ru` ставит один. Код общий: правка в ядре доезжает\nсюда обновлением зависимости, а не копированием.\n\n| нужно | пакет |\n|---|---|\n| только Авито | `avito-mcp-ru` |\n| все четыре маркетплейса | `marketplaces-mcp-ru` |\n\n## Кто это сделал\n\n[Илья Утов](https://github.com/ilyautov), лаборатория\n[AI Frontier](https://aifrontier.tech). Как эти инструменты устроены внутри,\nпишу в [Telegram](https://t.me/gorilla_under_hood) и\n[LinkedIn](https://www.linkedin.com/in/ilyautov).\n\nРядом стоят [**business-mcp-ru**](https://github.com/ilyautov/business-mcp-ru)\n(hh.ru, VK, Диадок, СБИС, Честный знак),\n[**moysklad-mcp-ru**](https://github.com/ilyautov/moysklad-mcp-ru) и\n[**humanizer-ru**](https://github.com/ilyautov/humanizer-ru).\n\nВсе проекты одним списком, разобранные по назначению:\n[ilyautov.github.io](https://ilyautov.github.io/).\n\n## Лицензия\n\nMIT, см. [LICENSE](LICENSE).\n",
  "bytes": 5672,
  "sha": "f18ccf7ff2774ab9af1ba5886a08b675e91a2755ef6abf899ef8c9220215f914",
  "repo_slug": "ilyautov/avito-mcp-ru",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ilyautov_avito_mcp_ru_3d31c2d6/readme"
}