API Авито: доступ и карта методов
Авито авторизуется по OAuth2, а не по постоянному ключу: пара client_id и client_secret меняется на токен с ограниченным сроком жизни. Обновление токена сервер берёт на себя.
Как получить доступ
Где взять пару
На avito.ru: Для бизнеса, раздел Интеграции, пункт API. Там выдаётся client_id и client_secret. Хост запросов api.avito.ru.
Как это превращается в токен
Пара меняется на access-токен по OAuth2, срок жизни ограничен. Сервер обновляет токен сам, вручную ничего перевыпускать не нужно.
Где всё лежит
В ~/.marketplace-mcp/cabinets.json с правами chmod 600, локально.
Карта методов
Таблицы собраны из того же каталога, который грузит сервер, поэтому они не расходятся с кодом. Колонки показывают, как метод классифицирует safety-гейт: перед записью агент предупреждает, перед необратимым действием требует подтверждения.
| Раздел | Методов | Чтение | Запись | Необратимые |
|---|---|---|---|---|
| Мессенджер (чаты с покупателями) | 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 |
| Всего | 64 |
Курированное ядро выверено на живых кабинетах. Остальное импортировано из спецификаций: пути надёжны, HTTP-глаголы не всегда, считайте такие записи картой для разведки. Официальная документация: developers.avito.ru.
Частые ошибки и что они значат
401 после того, как всё работало
Токен Авито живёт ограниченное время. Если запрос идёт мимо сервера, своим кодом, токен надо обновлять; через сервер это происходит само.
403 на методе, который есть в документации
У Авито доступ к разделам выдаётся по заявке и не одинаков у всех аккаунтов. Мессенджер и Авито Доставка открываются не каждому бизнесу.
Ошибка в имени поля
Каталог собран из официальных документов, живой прогон на реальных кабинетах ещё не делался. describe_method покажет схему, call_raw даст поправить запрос на месте.
То же самое одной фразой
Если разбираться с методами руками не хочется, всё перечисленное выше вызывается из чата обычными словами. Проект и есть MCP-сервер: он отдаёт эти методы ИИ-ассистенту как инструменты, а тот подбирает нужный сам.
Скажите так
покажи статистику по объявлениям за неделю какие заказы Авито Доставки в работе собери непрочитанные сообщения из мессенджера обнови остатки по объявлениямЧто для этого нужно
Ключи из первого раздела и одна строка установки. Нужен только Авито: отдельный пакет avito-mcp-ru, тот же сервер одним маркетплейсом. Нужны все четыре: npx -y marketplaces-mcp-ru или uvx marketplaces-mcp-ru, а в Claude Desktop бандл .mcpb из релизов ставится в один клик.
Частые вопросы
Как получить API-ключ Авито?
На avito.ru: раздел Для бизнеса, пункт Интеграции, подраздел API. Авито выдаёт не ключ, а пару client_id и client_secret, которая по OAuth2 меняется на токен с ограниченным сроком жизни.
Есть ли у Авито API для объявлений и мессенджера?
Да. В каталоге 64 метода: объявления и статистика, заказы Авито Доставки, мессенджер, продвижение, отзывы и рейтинг, остатки, автозагрузка объявлений файлом, баланс и операции.
Почему API Авито отвечает 403?
Доступ к разделам у Авито выдаётся по заявке и не одинаков у всех аккаунтов. Мессенджер и Авито Доставка открываются не каждому бизнесу.
Можно поставить только Авито, без остальных маркетплейсов?
Да, для этого есть отдельный пакет avito-mcp-ru: он поднимает один сервер Авито, без остальных площадок. Внутри тот же код и тот же каталог, что в marketplaces-mcp-ru, они приходят зависимостью. Строка установки лежит в его репозитории.
Каталог методов открыт. Берите, форкайте, улучшайте.
Всё это лежит в репозитории под MIT, включая машиночитаемые каталоги, из которых собраны таблицы на этой странице. Нашли неточность в методе, поправьте или заведите issue.