Avito Shopping MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Avito Shopping MCP find a used iPhone 15 in Kazan under 50,000 rubles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ищите объявления на Авито вместе с ИИ. 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 последних отзывов о продавце и перечисли
тревожные признаки, если они есть.Инструменты
Инструмент | Что делает |
| Ищет объявления: город (по умолчанию Москва), сортировка, цена от/до, страница и лимит |
| Читает объявление: цена, описание, характеристики, адрес, фото, дата, просмотры, продавец |
| Читает рейтинг продавца объявления и его свежие отзывы |
| Проверяет локальную сессию; |
| Создаёт или обновляет сессию в отдельном окне браузера |
Объявление можно передать ссылкой вида 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 провайдера и частые обновления страниц повышают шанс блокировки.
Как это работает
setupоткрывает Chrome, ждёт, пока Авито начнёт отдавать результаты поиска, и сохраняет сессию вне репозитория.MCP-инструменты повторно используют сессию в headless Chrome; все запросы идут из вкладки avito.ru.
Если Авито просит повторную проверку браузера, сервер один раз перезагружает главную страницу и повторяет запрос.
Если сессия больше не принимается, сервер просит явно запустить
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 toolsavito_healthCheck Avito MCP healthARead-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 listingBRead-onlyIdempotent
Get one Avito listing: price, description, characteristics, address and coordinates, photos, publication date, views, and seller profile.
Inputs: item (required).
avito_searchSearch Avito listingsARead-onlyIdempotent
Search Avito classifieds in one city. Returns listing ids, titles, prices, URLs, publication time, an image, and seller name and rating when Avito shows them.
Inputs: query (required), page, sort, limit, +3 more.
avito_seller_reviewsRead Avito seller reviewsARead-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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
The agent-native marketplace for AI data: search listings and read their price and rights.
Read-only Reddit search API for AI agents: posts, comments, comment trees, subreddit rules.
AI model ratings, Gateway prices in rubles, subscriptions and AI jobs in Russia. Read-only, no key.
Public read-only offers, prices, product details, links and safe AI integration guidance.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.22MIT
- AlicenseAqualityCmaintenanceEnables 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.127MIT
- AlicenseBqualityCmaintenanceEnables 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.4185MIT
- AlicenseAqualityCmaintenanceEnables 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.220 npm1MIT