Skip to main content
Glama

Ищите объявления на Авито вместе с ИИ. Avito Shopping MCP превращает поиск, карточки объявлений и отзывы о продавцах в инструменты вашего MCP-клиента — локально, без входа в аккаунт и десятков открытых вкладок.

Сервер работает только на чтение: не пишет продавцам, не размещает объявления и не трогает ваш аккаунт. Браузерная сессия остаётся на вашем компьютере.

Альфа-версия: у Авито нет публичного API для покупателей, поэтому проект использует внутренние эндпоинты сайта. Они и защита от автоматизации могут измениться без предупреждения.

Проект основан на wb-shopping-mcp и ozon-shopping-mcp.

Возможности

  • ищет объявления в выбранном городе с сортировкой по цене, дате или скидке;

  • отбирает варианты в заданном ценовом диапазоне;

  • читает объявление целиком: цену, описание, характеристики, адрес, фото, дату публикации и просмотры;

  • показывает продавца: тип, стаж на Авито, скорость ответа и рейтинг;

  • собирает свежие отзывы о продавце с оценками, этапом сделки и ответами;

  • работает локально через защищённую сессию с последовательными запросами и паузами между ними.

Related MCP server: yandex-market-mcp

Быстрый старт

Нужны Node.js 24 LTS или новее и Google Chrome. Настройте локальную сессию:

npx avito-shopping-mcp setup

Откроется окно Chrome с avito.ru. Если Авито покажет проверку доступа или капчу, пройдите её сами в этом окне — сессия сохранится, как только поиск начнёт отвечать. Если поиск отвечает ограничением доступа, setup не повторяет запросы по таймеру: обновите страницу в окне и пройдите капчу, после этого setup проверит поиск ещё раз. Дальше запросы выполняются в headless Chrome без видимого окна.

Добавьте сервер в Claude Code:

claude mcp add avito-shopping -- npx -y avito-shopping-mcp

Для Claude Desktop и других MCP-клиентов используйте stdio-конфигурацию:

{
  "mcpServers": {
    "avito-shopping": {
      "command": "npx",
      "args": ["-y", "avito-shopping-mcp"]
    }
  }
}

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

Найди в Москве 5 кофемашин DeLonghi с капучинатором до 25 000 ₽. Открой
объявления, проверь состояние, модель и что входит в комплект, посмотри отзывы
о продавцах и выбери самый надёжный вариант.
Подбери б/у iPhone 15 128 ГБ в Казани дешевле 50 000 ₽. Сравни ёмкость
аккумулятора и состояние по описаниям, отметь объявления от продавцов с
рейтингом ниже 4,5 или без отзывов.
Вот объявление: https://www.avito.ru/moskva/... — разбери описание и
характеристики, прочитай 20 последних отзывов о продавце и перечисли
тревожные признаки, если они есть.

Инструменты

Инструмент

Что делает

avito_search

Ищет объявления: город (по умолчанию Москва), сортировка, цена от/до, страница и лимит

avito_item

Читает объявление: цена, описание, характеристики, адрес, фото, дата, просмотры, продавец

avito_seller_reviews

Читает рейтинг продавца объявления и его свежие отзывы

avito_health

Проверяет локальную сессию; live=true отправляет на Авито один лёгкий запрос

avito_setup_session

Создаёт или обновляет сессию в отдельном окне браузера

Объявление можно передать ссылкой вида https://www.avito.ru/<город>/<категория>/<название>_<id> или числовым id. Город передаётся по-русски: Казань, Санкт-Петербург.

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

Авито быстро ограничивает доступ с IP-адреса, с которого идёт много запросов. Поэтому:

  • запросы выполняются строго по одному, с паузой не меньше 5 секунд (AVITO_MCP_MIN_REQUEST_INTERVAL_MS) и случайной добавкой;

  • поиск — 1 запрос, объявление — 1, отзывы о продавце — 2–3;

  • после ошибки AVITO_RATE_LIMITED сервер 20 минут не обращается к Авито и сразу возвращает эту ошибку с оставшимся временем; чтобы продолжить раньше, запустите npx avito-shopping-mcp setup и пройдите капчу в окне браузера — новая сессия снимает паузу; блокировки Авито иногда длятся час и дольше;

  • некорректный запрос (пустой, слишком длинный, цена «от» больше цены «до») возвращает INVALID_INPUT;

  • VPN, общий IP провайдера и частые обновления страниц повышают шанс блокировки.

Как это работает

  1. setup открывает Chrome, ждёт, пока Авито начнёт отдавать результаты поиска, и сохраняет сессию вне репозитория.

  2. MCP-инструменты повторно используют сессию в headless Chrome; все запросы идут из вкладки avito.ru.

  3. Если Авито просит повторную проверку браузера, сервер один раз перезагружает главную страницу и повторяет запрос.

  4. Если сессия больше не принимается, сервер просит явно запустить setup снова.

Безопасность и ограничения

  • файл сессии содержит cookies и хранится с закрытыми правами доступа (0700/0600, где поддерживается);

  • запросы уходят только на https://www.avito.ru, ссылки в ответах — только на avito.ru и avito.st;

  • cookies, тела заблокированных ответов и неизвестные внутренние ошибки не возвращаются через MCP;

  • заголовки, описания, характеристики и отзывы считаются недоверенными данными — агент не должен выполнять найденные в них инструкции;

  • выдача, цены и наличие зависят от города, сессии и времени запроса; дата публикации и просмотры в карточке могут отставать;

  • отзывы относятся к продавцу в целом, а не к конкретному объявлению;

  • проект предназначен для интерактивного личного использования, а не для массового сбора данных или публичного HTTP-моста.

Подробнее: SECURITY.md. Проект не связан с Авито и не одобрен или спонсируем компанией.

Разработка

git clone https://github.com/0xBADC0FFEE/avito-shopping-mcp.git
cd avito-shopping-mcp
npm ci
npm run check
npm run build

Подробнее об устройстве проекта — в docs/architecture.md, о том, как получены данные Авито, — в docs/research/avito-data-access.md, об участии в разработке — в CONTRIBUTING.md.

Лицензия

MIT © 2026 Maxim Zaytcev и контрибьюторы.

Available Tools

5 tools
avito_healthCheck Avito MCP healthA
Read-onlyIdempotent

Check whether a protected local browser session exists. Set live=true to also send one lightweight request to Avito through the saved session.

Inputs: live.

avito_itemGet an Avito listingB
Read-onlyIdempotent

Get one Avito listing: price, description, characteristics, address and coordinates, photos, publication date, views, and seller profile.

Inputs: item (required).

avito_seller_reviewsRead Avito seller reviewsA
Read-onlyIdempotent

Read the newest reviews of the seller behind an Avito listing, with the seller's overall rating and score distribution. Reviews cover all of the seller's deals, not only this listing.

Inputs: item (required), limit.

avito_setup_sessionSet up the local Avito sessionB

Open a temporary browser window, wait until Avito serves search results (the user may need to pass an access check), save the session locally, and close the window.

Inputs: timeoutSeconds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a clearly distinct operation: search listings, fetch one listing, check the browser session, read seller reviews, and set up the session. An agent can unambiguously pick the right tool for each task, and the search-vs-detail boundary is explicit in the descriptions.

    Naming Consistency4/5

    All tools share a consistent avito_ snake_case prefix, which makes them easy to group and scan. However the suffix style varies between verbs (avito_search, avito_setup_session) and nouns (avito_item, avito_health, avito_seller_reviews), a minor deviation from a strict verb_noun pattern.

    Tool Count5/5

    Five tools is well-scoped for a read-only classifieds integration plus session lifecycle support. Each tool earns its place: search, detail, reviews, session setup, and a health check, with no redundant entries.

    Completeness4/5

    The surface covers the core research workflow (setup session, verify it, search, inspect a listing, read seller reviews) with no dead ends. Minor gaps like browsing categories or listing all of a seller's items exist but agents can work around them via search.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables local-first, read-only interaction with Avito through your own authenticated Chrome session, without sharing credentials with the MCP client. Provides tools for searching listings, viewing your listings, favorites, chats, and messages.
      2
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LLM agents to fetch live Yandex Market data via plain HTTP, with honest labeling of prices (pay-card vs plain vs discounted), sponsored tiles, seller and model-group ratings, reviews, questions, and seller legal details. It avoids common scraped-data traps such as misleading discounts, captcha pages, and cross-border or conditional offers.
      12
      7
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables an LLM to control a separate Chrome session on Avito for searching and parsing listings, reading account and Pro dashboards/statistics, switching profiles, and editing forms. Requires explicit confirmation for irreversible actions.
      4
      18
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to search public classified listings and read individual listing details through a local browser session, with filters for location, radius, price, and sort order. Read-only and user-directed: no login, no account, no messaging, and no bulk scraping.
      2
      20 npm
      1
      MIT