Как подключить Avito к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Avito, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Avito + Gemini

Подключите ИИ к бизнес-аккаунту Авито: список объявлений и изменение цен, статистика просмотров, контактов и звонков, проверка выгрузок автозагрузки и их ошибок, формат фида и кошелёк, а также чтение чатов в Авито Мессенджере. Отправка сообщений и изменение настроек автозагрузки подключаются по желанию и по умолчанию выключены.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

AVITO_CLIENT_ID, AVITO_CLIENT_SECRET

Шаг 1 — Получите учётные данные

Настройка занимает около 5 минут. Нужен бизнес-аккаунт Авито и его ключи API, входить через браузер не придётся.

1. Войдите на Авито под тем бизнес-аккаунтом, с которым будет работать ИИ: под основным аккаунтом компании, а не под аккаунтом сотрудника.
2. Откройте Для профессионалов, затем API интеграции (avito.ru/professionals/api) и скопируйте Client ID и Client secret. Авито выдаёт одну пару ключей на аккаунт, и после генерации нового секрета старый перестаёт работать.
3. Вставьте их в AVITO_CLIENT_ID и AVITO_CLIENT_SECRET и установите коннектор. AnythingMCP сам получает токен доступа у Авито и обновляет его каждые 24 часа.
4. Запустите avito_get_self: он покажет имя, email и ID пользователя аккаунта. Этот ID и есть user_id, который нужен остальным инструментам, и ИИ использует его до конца разговора.

Возможности зависят от тарифа Авито: через API доступно то же, что разрешено самому аккаунту. Messenger API есть только на тарифе Максимальный для товаров и работы и на Расширенный или Максимальный для услуг; без него инструменты чатов отвечают 403. Для инструментов автозагрузки она должна быть настроена в аккаунте.

Что он читает: аккаунт и кошелёк (рубли и бонусы) со списаниями за размещение и продвижение; ваши объявления с названием, ценой, статусом, категорией, адресом и подключёнными платными услугами (vip, highlight, pushup, premium, xl) с датой окончания; уникальные просмотры, контакты и добавления в избранное для 200 объявлений за раз и до 270 дней назад; звонки по объявлениям и по дням; настройки автозагрузки, каждую выгрузку с ошибками и предупреждениями по каждому объявлению; поля фида для любой категории; а также чаты и сообщения в Авито Мессенджере. Объявления субаккаунтов сотрудников в список не попадают, а чтение чата не отмечает его прочитанным.

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

Спрашивает перед каждым изменением: avito_update_item_price меняет цену одного объявления в целых рублях (товары, запчасти, автомобили и недвижимость, кроме краткосрочной аренды). Новая цена сразу видна всем, поэтому ИИ сначала называет объявление, старую и новую цену и ждёт вашего согласия. Если объявление приходит из фида автозагрузки, следующая выгрузка может вернуть цену из фида: поменяйте её и в фиде.

Отключено при установке: avito_send_message (пишет покупателю от имени аккаунта, не больше 1 000 символов, отозвать сообщение отсюда нельзя), avito_mark_chat_read (значок непрочитанного пропадает, и коллеги могут пропустить сообщение), avito_update_autoload_profile (заменяет весь профиль автозагрузки целиком) и avito_start_autoload_upload (сразу публикует все объявления из фида без учёта лимитов расписания, что может стоить денег за размещение, и запускается не чаще раза в час). Администратор включает их осознанно, и даже тогда ИИ показывает точный текст или точное изменение настроек и ждёт вашего подтверждения.

Данные покупателей: в чатах есть имена и сообщения покупателей. ИИ использует их только для ответа этим покупателям и никогда не пишет тем, кто не написал первым.

Время: Авито работает по московскому времени (UTC+3), и ИИ пересчитывает время, прежде чем его назвать, если вы в другом часовом поясе.

Ограничения: список объявлений не больше 25 запросов в минуту, изменение цен 150 в минуту, чтение одного объявления 500 в минуту. История операций кошелька отдаётся не больше чем за неделю за один запрос и не дальше года назад. После ответа 429 ИИ ждёт минуту и повторяет.

Частые ошибки: 401 Bad bearer token или 403 invalid access token значит, что Client ID или секрет неверны или их заменил новый сгенерированный секрет. Любой другой 403 значит, что тариф не включает этот API (чаще всего Мессенджер). 404 значит, что объявления, чата или выгрузки нет или они принадлежат другому аккаунту; отчёты автозагрузки отвечают 404 и тогда, когда выгрузок ещё не было. 400 значит, что неверен параметр, например цена в категории, где её здесь менять нельзя, или период по кошельку длиннее недели.

Коннектор не работает с услугами продвижения и их ценами, рекламными кампаниями, CPA и коллтрекингом, доставкой и заказами, рейтингом и отзывами, Авито Работой, краткосрочной арендой, аккаунтами сотрудников, вебхуками, отправкой фото и голосовых сообщений, и не создаёт и не редактирует содержимое объявлений: это делается через ваш фид автозагрузки.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Avito.

Доступные инструменты

Примеры запросов

• «Какие из моих активных объявлений за последние 30 дней собрали больше всего просмотров и контактов, а какие не получили ни одного?»
• «Снизь цену на объявление iPhone 13 128 ГБ до 42 000 ₽. Сначала покажи старую и новую цену.»
• «Были ли ошибки в последней выгрузке автозагрузки? Перечисли объявления с ошибками и подскажи, что поправить в фиде.»
• «Какие чаты в Мессенджере Авито не прочитаны и о чём спрашивают покупатели?»
• «Сколько списали с кошелька Авито за прошлую неделю и за что, и какой сейчас баланс?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT