Авито в LidFly

Подключение профиля Авито для работы с объявлениями, сообщениями, заказами, отзывами и продвижением. Рекламные кампании подключаются отдельно через кабинет «Авито Реклама».

MCP-сервер: https://lidfly.ru/mcp/v3

Два независимых подключения

Авито · provider="avito" Профили, объявления, сообщения, отзывы, заказы, остатки, продвижение и партнёрские API. Scope профиля: connection_id + avito_user_id.

Авито Реклама · provider="avito_ads" Рекламные аккаунты, кампании, группы, креативы, бюджеты и статистика. Scope рекламы: connection_id + account_id.

Подключение профиля Авито не меняет тариф в самом Авито. Кабинеты «Авито Реклама» подключаются и учитываются отдельно.

Как подключить

Откройте Авито в кабинете LidFly.
Нажмите Подключить через Авито и подтвердите нужные права.
LidFly проверит профиль и определит, с какими разделами можно работать.
Если для конкретного действия понадобятся дополнительные API-ключи, откройте вкладку API-ключи и один раз введите Client ID и Client Secret.

Client Secret и OAuth tokens шифруются и никогда не возвращаются в UI, MCP или логи. Несколько профилей можно подключить одновременно и выбрать основной.

Почему LidFly может не показать подписку «Ультра»

Подписка Авито и доступ к Avito API — не один и тот же признак. Публичный метод GET /tariff/info/1 показывает только тариф категории «Транспорт», который не относится к CPA. Он не предназначен для проверки общей подписки «Ультра» в других категориях.

Если Авито отвечает 404 «Тариф не найден», LidFly показывает результат «не применимо», а не ошибку подключения. Это не ограничивает другие возможности: ИИ продолжит запрошенное действие и отдельно проверит, доступен ли нужный для него инструмент.

Агентский кабинет Avito Promo

Агентство может отдельно подключить Avito Promo во вкладке Агентство. LidFly запросит POST /api/1/agency/clients с extra.subscription=true и покажет прикреплённых клиентов, категорию и уровень подписки, активность и дату окончания.

Личному профилю это подключение не требуется. Подписка клиента агентства используется только для диагностики: доступность объявления, сообщения или другой операции ИИ проверяет по ответу соответствующего метода Авито.

Для работы в Пространстве прикрепите конкретного клиента агентства к нужному проекту. Scope такого проекта содержит connection_id + agency_client_id, поэтому данные разных клиентов не смешиваются.

Capability-driven доступ

Каталог инструментов полный, но конкретный профиль может выполнять только операции, которые разрешил Авито. Доступ считается подтверждённым после успешного вызова конкретной операции. Если права не выданы, LidFly объясняет причину и не отключает остальные возможности профиля.

available — доступ подтверждён;
configured_unverified — OAuth или Client credentials настроены, но конкретная операция ещё не проверена;
unavailable — scope или партнёрский API не выдан, остальные разделы продолжают работать.

Для безопасного чтения с двумя допустимыми способами LidFly сначала использует ранее подтверждённый credential. Если Авито отвечает HTTP 401/403, выполняется не более одной попытки через альтернативный credential того же профиля. Ошибки параметров, отсутствие объекта, rate limit, сбой провайдера или сети не вызывают переключение.

Кнопка «Проверить» использует тот же порядок credentials: профиль остаётся рабочим, если ответил хотя бы один способ. Временная ошибка или отказ отдельной операции показываются в диагностике, но не отключают остальные инструменты профиля.

Покрытие каталога Avito API

Checked-in manifest содержит 248 операций во всех 25 разделах: 138 актуальных бизнес-действий, 69 операций с отдельным партнёрским доступом, 13 deprecated с заменами, 4 инфраструктурных Auth и 24 операции отдельного провайдера Ads.

Группа	Разделы	Что доступно
Профиль и аналитика	User, Item, Tariff	Профиль, объявления, статистика и тарифы.
Коммуникации	Messenger, Ratings, Special Offers	Чаты, сообщения, отзывы и специальные предложения.
Коммерция	Autoload, Stock, Orders, Promotion	Автозагрузка, остатки, заказы и услуги продвижения.
Продвижение	Auction, Autostrategy, CPA, CPX Promo, TrxPromo	Ставки, стратегии и продвижение с preflight цены и баланса.
Вертикали	Job, STR, Realty, CallTracking	Работа, краткосрочная аренда, аналитика недвижимости и звонки.
Иерархия компании	Accounts Hierarchy	Сотрудники, телефоны компании и закрепление объявлений.
Нужен отдельный доступ	Autoteka, Доставка, Avito Promo	Автотека и Доставка требуют отдельных договоров. В Avito Promo опубликован только безопасный read-only каталог клиентов агентства; остальные операции остаются в проверяемом покрытии, но не публикуются как инструменты.
Отдельно	Auth, Ads	Auth реализован инфраструктурно; Ads остаётся в Авито Рекламе.

Работа через ИИ

ИИ вызывает get_provider_context({ provider: "avito" }) и выбирает точные connection_id и avito_user_id.
Находит действие через search_tools({ provider: "avito" }) и получает его контракт через get_tool_schema.
Чтения запускает через call_tool; изменения — только через call_write_tool после вашего подтверждения.
После записи перечитывает объект и показывает состояние до/после.

Кампании нельзя искать через resolve_campaign_scope(provider="avito"): этот meta-tool относится к рекламному провайдеру avito_ads.

Как безопасно обновлять объявления через Autoload

У Avito API нет одного универсального метода для изменения описания, телефона, часов работы и всех остальных полей существующего объявления. Такие изменения вносятся в полную запись объявления в исходном фиде, после чего запускается обработка этого фида.

ИИ читает профиль Автозагрузки и текущую или последнюю успешную загрузку, чтобы показать URL и охват фида.
В источнике фида обновляется нужная полная запись. Её Id нельзя менять: по нему Авито распознаёт объявление между загрузками.
Перед запуском ИИ предупреждает, что будут обработаны все подходящие объявления файла, и просит явное подтверждение.
После обработки ИИ проверяет связь Id → Avito ID и результат по каждому объявлению через методы v4.

Расписание и URL фида меняются отдельно в настройках профиля. Перед записью ИИ читает текущие настройки и отправляет полный профиль целиком: autoload_enabled, feeds_data, report_email и schedule. Поля самого объявления меняются в фиде, если они поддерживаются выбранной категорией.

Не считайте сохранение Avito ID и накопленной статистики безусловной гарантией. Неизменный Id нужен для распознавания того же объявления, но итог всегда следует подтвердить после загрузки. Новый или изменённый Id может привести к созданию другого объявления.

Через API можно запустить только одну полную выгрузку в час. При неопределённом результате ИИ не повторяет запуск, а проверяет текущую загрузку.

Безопасность записей

HTTP method не определяет безопасность: read/write-класс задан manifest, потому что часть чтений Авито использует POST.
Read-запрос может безопасно повториться при сети, 429 или 5xx; write-запрос не повторяется автоматически.
Write-запрос после отправки никогда не переключается между OAuth и Client credentials, поэтому одно изменение не дублируется.
Деньги, продвижение, доступы, заказы, статусы, blacklist, рассылки, юридические операции, изменение полного профиля Autoload и запуск полного фида помечены как destructive.
При timeout или 5xx после отправки результат становится unknown/ambiguous. ИИ проверяет его через get_write_operation_status и не отправляет write повторно.
Автозапуски первого релиза могут использовать только read-инструменты Авито.

Webhook и приватные файлы

Регистрация webhook Messenger/Job временно недоступна до запуска обработки событий. LidFly не включает webhook, который только накапливал бы приватные сообщения или отклики без пользовательского сценария; защитный срок хранения event payload ограничен семью днями.

Для загрузки изображения в Messenger ИИ передаёт media_id своей картинки или публичный media_url. LidFly сам проверяет файл и формирует multipart-запрос Авито — передавать служебное поле uploadfile[] вручную не нужно.

Голосовые сообщения, записи звонков и PDF-этикетки хранятся вне публичных сайтов. Для скачивания нужны активная сессия владельца и подписанная ссылка, которая действует 15 минут.