avito-mcp

MCP-сервер, через который LLM работает на Авито как человек: ищет и разбирает объявления, читает личный кабинет и статистику, переключает профили, кликает, заполняет формы. Необратимые действия выполняются только после явного подтверждения.

Сервер управляет отдельным окном Google Chrome по протоколу CDP. В этом окне вы один раз входите в свой аккаунт, и сессия сохраняется между перезапусками. Ключи API Авито и платный тариф не нужны. Подтверждать каждый клик, как в браузерных расширениях, тоже не нужно.

Неофициальный проект, с Авито не связан. Используйте его для своего аккаунта и в рамках правил Авито. Подробнее — в разделе «Ограничения и ответственность».

English summary at the end of this file.

Содержание

• Зачем это нужно

• Что умеет

• Как это устроено

• Установка

• Подключение к клиентам MCP

• Первый запуск и вход в аккаунт

• Справочник инструментов

• Безопасность

• Настройки

• Вспомогательные скрипты

• Примеры запросов к агенту

• Решение проблем

• Разработка

• Ограничения и ответственность

Related MCP server: Avito Personal MCP

Зачем это нужно

Дать LLM доступ к Авито можно несколькими способами, и у каждого есть недостатки:

avito-mcp выбирает середину:

• Живой браузер с вашим входом. Это обычный Chrome со своим профилем, а не headless-скрейпер.

• Универсальные инструменты: открыть, прочитать, кликнуть, ввести текст. Агент справится, даже если Авито поменяет вёрстку.

• Готовые извлекатели данных поверх них: выдача, объявление, кабинет, профили. Это экономит токены и время.

• Защитный слой: только домен avito.ru, подтверждение необратимых действий, передача капчи человеку.

Что умеет

• Поиск. Выдача по запросу, городу, разделу, цене и сортировке. По каждой карточке: позиция, цена, строка прайса, продавец, рейтинг, число отзывов, бейджи, признак платного продвижения.

• Разбор объявления. Заголовок, цена, прайс-лист, параметры («Подробности»), описание, адрес, продавец, бейджи, отрывок отзывов. Фото в полном размере: сервер проходит по миниатюрам галереи. Если объявление ваше, ещё и статистика за 7 дней: показы, просмотры, избранное, контакты, расходы.

• Личный кабинет. Свои объявления во всех вкладках (активные, с ошибками, архив и т. д.) со строкой статистики. Работает и в обычном кабинете, и в Авито Pro.

• Профили аккаунта. Список профилей из меню аватара и переключение между ними, например между обычным профилем и профилем Pro.

• Любая страница Авито: сообщения, избранное, настройки продвижения, форма редактирования. Через снимок кликабельных элементов со стабильными ссылками ref.

• Редактирование форм. Ввод в поля с масками (цены), выпадающие списки, точечная замена фраз в описании. Описание на Авито сделано на Draft.js, и сервер сверяет итоговый текст, а не перезаписывает его целиком.

• Фото. Скачивание фото объявлений с avito.st (и товаров с ozone.ru, wbbasket.ru) в папку, снимки экрана страницы.

• Ozon и Wildberries. В том же окне открываются ozon.ru, wildberries.ru и кабинеты продавца (seller.ozon.ru, seller.wildberries.ru). Готовых извлекателей для них нет: агент работает через avito_open → avito_read / avito_click. В ответе есть site (avito, ozon, wildberries); JS-проверку Ozon «Antibot Challenge» и заглушку WB сервер просто пережидает, настоящую капчу проходит человек.

Как это устроено

 LLM-клиент (Claude Code, Claude Desktop, Codex, Cursor…)
        │  MCP по stdio
        ▼
 avito-mcp (Python, FastMCP + Playwright)
   ├─ браузер: запуск Chrome, подключение по CDP, паузы между переходами
   ├─ извлекатели: JS по атрибутам data-marker с запасным вариантом «текст страницы»
   ├─ защита: белый список доменов, confirm=true для рискованных кнопок, детектор капчи
   └─ инструменты: 20 штук (см. справочник)
        │  CDP только на 127.0.0.1:9333
        ▼
 Google Chrome со своим профилем ~/.avito-mcp/chrome-profile  ←  вход выполняет человек
        │
        ▼
 avito.ru

• Chrome живёт отдельно от сервера. При первом вызове сервер запускает его как обычный процесс со своим профилем и портом отладки. Окно и вход в аккаунт переживают перезапуск MCP-клиента. Если окно закрыть, сервер откроет его снова.

• Никаких обходов защиты. Сервер не подменяет user-agent, не ставит «стелс»-патчи, не решает капчи. Между переходами по страницам держится пауза: по умолчанию 2,5 с плюс случайные 0–1,5 с.

• Извлекатели опираются на атрибуты data-marker. Они стабильнее CSS-классов. Если разметка не распознана, инструмент возвращает текст страницы: модель продолжит работу, а не упадёт.

Установка

Требования: macOS или Linux, Python 3.12+, uv, установленный Google Chrome.

git clone https://github.com/ermizin/avito-mcp.git
cd avito-mcp
uv sync

Ставить браузеры Playwright не нужно: используется ваш Google Chrome. На Linux или при нестандартном пути к Chrome задайте AVITO_MCP_CHROME (см. настройки).

Проверка, что сервер запускается и видит Авито:

uv run python scripts/smoke.py avito_status

Откроется окно Chrome с Авито, а в терминале появится JSON: url, title, blocked, logged_in.

Подключение к клиентам MCP

Во всех примерах /ABS/PATH/avito-mcp — абсолютный путь к клонированному репозиторию.

Claude Code

claude mcp add -s user avito -- /ABS/PATH/avito-mcp/.venv/bin/python -m avito_mcp
claude mcp get avito   # Status: ✔ Connected

Claude Desktop, Cursor и другие клиенты с JSON-конфигом

{
  "mcpServers": {
    "avito": {
      "command": "/ABS/PATH/avito-mcp/.venv/bin/python",
      "args": ["-m", "avito_mcp"]
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.avito]
command = "/ABS/PATH/avito-mcp/.venv/bin/python"
args = ["-m", "avito_mcp"]

Через uv без активации окружения:

uv run --directory /ABS/PATH/avito-mcp avito-mcp

Первый запуск и вход в аккаунт

1. Попросите агента вызвать avito_status или запустите scripts/smoke.py avito_status. Откроется окно Chrome с профилем ~/.avito-mcp/chrome-profile.

2. Если logged_in: false, войдите в Авито сами в этом окне. Агент пароли и коды из СМС не вводит.

3. Если Авито показал «Доступ ограничен» (blocked: true), пройдите проверку в окне сами. Агент вызывает avito_wait_for_user и ждёт.

4. Готово: дальше сессия сохраняется в профиле.

Уже есть отдельный профиль Chrome, где выполнен вход в Авито? Укажите его в AVITO_MCP_PROFILE. Профиль, который сейчас открыт в другом окне Chrome, не подойдёт: Chrome блокирует профиль.

Справочник инструментов

Состояние и навигация

Чтение страницы

Действия

Данные Авито

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

Модель читает чужой контент: объявления, отзывы, сообщения. Значит, она может наткнуться на текст, который пытается ею управлять. Поэтому ограничения встроены в сам сервер, а не только в инструкции.

Фильтр рискованных кнопок — эвристика по тексту кнопки, а не гарантия. Для действий, которые меняют ваш аккаунт или стоят денег, держите в клиенте ручное подтверждение вызовов инструментов. Перед confirm=true всегда проверяйте, что именно агент собирается сделать.

Настройки

Переменные окружения:

Развёртывание на сервере

На Linux-сервере Chrome работает на виртуальном дисплее (Xvfb). Для входа в аккаунт и капчи к дисплею подключаются через x11vnc и noVNC по SSH-туннелю. Пример юнита systemd:

[Service]
User=ubuntu
Environment=DISPLAY=:91
Environment=AVITO_MCP_TRANSPORT=streamable-http
Environment=AVITO_MCP_CHROME=/opt/google/chrome/chrome
Environment="AVITO_MCP_CHROME_ARGS=--disable-dev-shm-usage --disable-gpu --window-size=1100,800"
Environment="AVITO_MCP_BEFORE_START=sudo -n /usr/bin/systemctl stop game-server"
Environment="AVITO_MCP_AFTER_IDLE=sudo -n /usr/bin/systemctl start game-server"
Environment=AVITO_MCP_IDLE_SECONDS=900
ExecStart=/home/ubuntu/avito-mcp/.venv/bin/python -m avito_mcp

Хуки нужны, если серверу не хватает ресурсов. На время работы с Авито они освобождают процессор от другого сервиса, а после простоя возвращают его. Инструмент avito_close_browser освобождает ресурсы сразу, не дожидаясь простоя. HTTP-порт держите на 127.0.0.1 и выставляйте наружу только через обратный прокси с OAuth или токеном: этот сервер управляет вашим аккаунтом.

Вспомогательные скрипты

Все скрипты запускают сервер по stdio и вызывают его инструменты, как это делал бы MCP-клиент. Они удобны для отладки и пакетных задач.

Скрипты правок нарочно разделены на «заполнить» и «сохранить»: сначала человек проверяет результат, потом сохраняет.

Примеры запросов к агенту

• «Найди на Авито в Москве объявления по запросу „ремонт iPhone“, отсортируй по цене и покажи топ-10 с рейтингом продавцов».

• «Открой мои объявления, переключись на профиль Pro и сведи в таблицу просмотры, контакты и конверсию по каждому».

• «Разбери 15 первых объявлений конкурентов по запросу „увеличение губ“: цены, длина описаний, сколько отзывов, у кого продвижение».

• «Посмотри, что во вкладке „С ошибками“, и объясни, почему объявление отклонено».

• «Подготовь новый прайс-лист для объявления X, заполни форму, но не сохраняй — покажи, что получилось».

Решение проблем

Разработка

uv sync
uv run pytest -q                       # тесты логики без браузера
uvx ruff check --select E,F,B,I src    # линтер

Код:

• src/avito_mcp/browser.py — запуск Chrome, CDP, паузы, белый список доменов, детектор капчи и входа;

• src/avito_mcp/extract.py — JS-извлекатели, снимок элементов со стабильными ref, замена фрагмента в Draft.js;

• src/avito_mcp/server.py — инструменты MCP и защитный слой.

Авито регулярно меняет вёрстку. Если извлекатель сломался, начните с avito_read(mode="snapshot") и avito_read(mode="text") на нужной странице: найдите новые data-marker и обновите JS в extract.py.

Ограничения и ответственность

• Проект неофициальный. Он работает через веб-интерфейс, поэтому может сломаться при изменениях на Авито.

• Вы отвечаете за соблюдение правил Авито. Правила запрещают автоматизированный массовый сбор данных и рассылки. Используйте сервер для своего аккаунта и разумных объёмов, не убирайте паузы и не пытайтесь обходить капчу или ограничения.

• Персональные данные. Сообщения и данные чужих объявлений — персональные данные. Не сохраняйте и не публикуйте их без необходимости.

• Проверено на macOS с Google Chrome на страницах avito.ru (выдача услуг, объявления, кабинет и кабинет Pro, форма редактирования, настройки цены просмотра) в октябре 2026. Мобильная версия и приложение не поддерживаются.

Лицензия — MIT.

English summary

avito-mcp is an unofficial MCP server that lets an LLM operate Avito (Russia's largest classifieds site) the way a person would. It drives a dedicated Google Chrome window over CDP. You sign in once yourself and the session persists. No Avito API keys or paid plan are needed, and the agent doesn't need click-by-click approval.

• 20 tools. Generic ones: open, read (text or a compact snapshot with stable refs), click, hover, type, replace_text, press, scroll, screenshot. Avito-specific ones: search results with positions and promotion flags, full listing parsing including full-size photos and owner stats, your own listings across cabinet tabs (incl. Avito Pro), and account profile switching.

• Safety built into the server:

  • navigation is limited to avito.ru;

  • irreversible controls (send, publish, delete, pay, save…) require confirm=true;

  • CAPTCHAs are handed to the human, never bypassed;

  • no credential handling; CDP stays on loopback;

  • every page navigation is rate-limited.

• Install: uv sync, then register /ABS/PATH/avito-mcp/.venv/bin/python -m avito_mcp as a stdio MCP server.

MIT licensed. Use it with your own account and within Avito's terms of service.