avito-mcp
Buyer-side, read-only research on Avito's computer-goods listings (default Yekaterinburg) — no account, API key, or contact/purchase actions.
Search listings (
search_listings) across new/used/unknown items with query, city, page, sort (relevance/price/newest), price bounds, seller type (all/private/company), local-only city filtering, and up to 50 results per page — returning prices, links, seller ratings and snippets.Find used parts (
search_used_parts) by verifying seller-declared Б/у condition in up to 5 full card reads per page, withoffset/pagecontinuation and counts of excluded new/unknown items.Read full listing cards (
get_listing) for price, condition, structured model/specs, description, seller rating/type, and quoted defect/mining/repair/testing text signals.Compare up to 5 listings (
compare_listings) side by side on model, memory, condition, accessories, defects and price.Check local status (
get_status) — default city, saved session presence, request count and cooldown, without contacting Avito.All tools are read-only and idempotent; prices are asking prices, used-condition and defect mentions are text signals (not diagnoses), and listings may already be sold.
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-mcp Find used RTX 3060 12GB in Yekaterinburg under 25,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-mcp
English · Русский
Buyer-side MCP server for Avito, focused on used PC components in Yekaterinburg. Search live listings, inspect a full card and its seller, read account reviews, and compare exact offers. No Avito account or API key is required.
It reads the public storefront in a normal Playwright Chromium or Firefox session. It is unofficial and does not use Avito's seller/business API.
Experimental: Firefox rendered a real public profile and 25 reviews during 0.2.0 validation; a subsequent request was blocked. Access is intermittent in both engines. See the actual checks and limitations.
What it gets right
Search results can include other cities.
local_only=true(default) checks each listing's URL city and excludes those offers. The page heading alone is not proof that every result is local.search_used_partsopens full cards and only returns an explicit Б/у in the structured condition field. It does not infer used condition from a snippet, and does not pretend an ignored native condition parameter worked.A used part can be broken. Repair, mining, defect and testing mentions carry excerpts and are text signals, not a diagnosis or a fraud score. Negated phrases such as “без артефактов” can also produce a mention.
Prices are asking prices, excluding unknown shipping/fees. From-prices and instalments are not passed off as a full item price. Missing values stay null.
Seller ratings are labelled as seller ratings, not hardware-model ratings.
Native price, seller-type and sort controls are checked in the returned page; ignored or changed filters fail explicitly. Requested price bounds are also applied locally to parsed prices.
Every network result includes its source URL and
fetched_at. Unexpected layouts fail instead of returning a fake empty result.
Related MCP server: Avito Personal MCP
Tools
Tool | Purpose |
| One page of computer-goods listings (new/used/unknown), asking prices, seller ratings, snippets and links. Sort: |
| Search plus up to 5 full card reads, default 3. Returns only seller-declared used items; reports new/unknown/unavailable exclusions. Continue with |
| Full title, price, structured model/condition/specs, description, seller rating/type, date text, views and quoted hardware signals. |
| Registration text, account rating and star distribution, Avito badges, active/closed listing counts, followers, and a sample of reviews about selling. |
| Review text, score, date, reviewer role, item and transaction status. Filter low scores locally; load up to 3 additional batches. |
| Full item and seller in two page reads. Keeps the item with an explicit failed seller check if the profile is unavailable. |
| Compare up to five items and sellers by default; fetch shared profiles once. Set |
| Local default city, saved-session presence and remaining cooldown; no network request or credentials. |
Example requests:
Find used RTX 3060 12GB in Yekaterinburg under 25,000 rubles.
Check the full cards; separate 3060 Ti and broken/repair offers.
Compare these two listing URLs: exact model, memory, seller, condition,
price and what the seller says about repairs or tests.
Check account age and reviews specifically about selling, including low scores.Install
Python 3.11+, a Playwright browser and its system libraries are required. Docker and an account are not required. A display is needed only for the optional manual browser window.
With uv:
uvx --from playwright playwright install firefox
codex mcp add avito --env AVITO_CITY=ekaterinburg --env AVITO_BROWSER=firefox -- uvx --from git+https://github.com/SZhukovWork/avito-mcp avito-mcpThe browser version must match the installed Playwright package. If the
server reports a missing browser, use the checkout instructions below to
install it with that exact Python environment. On a minimal Debian/Ubuntu
machine, python -m playwright install --with-deps firefox installs OS
dependencies as well (requires the appropriate system privileges).
From a checkout:
python3 -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'
.venv/bin/python -m playwright install firefox
export AVITO_BROWSER=firefox
.venv/bin/avito-mcpAny stdio MCP client:
{
"mcpServers": {
"avito": {
"command": "/absolute/path/to/.venv/bin/avito-mcp",
"env": {"AVITO_CITY": "ekaterinburg", "AVITO_BROWSER": "firefox"}
}
}
}For Codex, allow enough time to compare up to five items and their sellers:
[mcp_servers.avito]
command = "/absolute/path/to/.venv/bin/avito-mcp"
startup_timeout_sec = 30
tool_timeout_sec = 900
[mcp_servers.avito.env]
AVITO_CITY = "ekaterinburg"
AVITO_BROWSER = "firefox"Configuration
Variable | Default | Meaning |
|
| Avito city slug. |
|
| Seconds between page reads in this process; minimum 3. Parallel tools share one browser lock. |
|
|
|
|
|
|
| unset | Optional Playwright proxy server URL for the selected engine. No proxy rotation. |
|
| Navigation timeout in seconds (10–90), plus up to 15 seconds for rendering. |
|
| Close the browser after this many idle seconds (minimum 30). |
|
| Pause after an unresolved access challenge (minimum 60), persisted across restarts. |
|
| Separate Chromium/Firefox state and a shared pause marker. Created directory mode 0700; session files 0600. |
The MCP uses its own session; it does not read your personal Firefox/Chrome profile, cookies, passwords or tabs. A site working in personal Firefox does not guarantee that the separate MCP session will be accepted. Changing engines does not clear the shared access cooldown.
The browser launches lazily, not during MCP initialization. No browser downloads occur silently at startup. Ordinary tool calls make only reads of public pages; they do not reveal phone numbers, contact sellers, add to cart, order, or pay.
Access checks and manual setup
Avito can limit an IP, show a captcha, or warn about a VPN. If usable listing
data is absent, the server stops and reports the problem. It never solves a
captcha automatically or rotates proxies. A warning overlay alongside parsed
data is reported in site_warning, not hidden.
Check the site in a browser, wait for the restriction to expire, or run:
avito-mcp browserComplete any challenge yourself in the separate window, then press Enter in
the terminal to save its session and close it. This explicit setup clears the
local cooldown; it does not guarantee that Avito accepts the next request.
Use avito-mcp status to see the local state. Account login is not required and
this server does not expose account actions. If you log in manually, the saved
browser state can contain account credentials: do not share or commit it.
Limits and interpretation
Computer goods only in this release. Search can match irrelevant products or accessories: check the full model; “RTX 3060” also matches Ti and other cards.
Used search is a bounded scan, not a site-wide native Б/у filter. It may return no items after inspecting three new listings even when used ones exist later.
next_offsetandnext_pagemake this explicit. Pages can shift, so deduplicate by listing id when continuing.total_foundis Avito's total before local filtering.limittruncates the current page; increase it to 50 to inspect the rest rather than assumingnext_pageresumes after the last returned item.Local filtering uses URL city, not distance or a pickup address. Delivery estimates and landed cost are not quoted.
Reviews default to
role="seller": written by a buyer about the account's selling activity.role="buyer"selects reviews written by sellers about the account's purchases. The aggregate rating and star histogram may mix both roles.Review filtering is local to the loaded window.
rating_max=3with zero matches does not prove the entire account has no low scores.has_more_on_sitesignals remaining reviews. Keepload_moreunchanged fornext_offset; increase it up to 3 to expand the window, deduplicating by content fingerprint. No native global low-rating filter or full-history claim is made.Review dates retain the displayed text; missing years are not guessed. Review replies and image contents are not extracted in this release.
A profile snapshot is reused for up to 60 seconds in the same process when the requested
load_moreis unchanged.cache_hit,cache_age_secondsand the originalfetched_atmake reuse explicit.Closed listings are not a count of completed sales. Avito badges are labels shown by the platform; absent badges mean unknown, not failed verification.
inspect_listingand comparison returnseller_check.status(available,partialorunavailable). This describes retrieved data, not trustworthiness.No claim of availability beyond the rendered page, no guarantee of working condition, no completed-sales history, no image diagnosis, no full seller review history guarantee and no reliable promoted-listing detection.
Contact patterns in descriptions are masked. Public seller display names and profile links are retained; phone-reveal endpoints are never called.
Rate spacing is per process. Avoid running multiple clients against the same IP at once. Avito may change its UI/markers at any time.
Development
python -m pytest # offline parsers + real MCP stdio handshake
python -m pytest -m browser # local Firefox fixture; no Avito requests
python -m pytest -m live -s # optional: one search + one card against AvitoOffline tests use synthetic markup matching observed DOM structures; no browser
session, private data, captured page scripts or cookies are shipped. Live tests
are excluded from the CI template in ci/github-actions.yml. To enable GitHub
Actions, copy it to .github/workflows/tests.yml and push with a credential that
allows workflow changes. It is not active in this initial repository publication.
See VALIDATION.md for the release checks.
Not affiliated with Avito. Intended for occasional personal buyer research. Respect the site's terms and request limits. MIT license.
Available Tools
5 toolscompare_listingsARead-onlyIdempotent
Refresh up to five exact listings side by side. No automatic bargain/risk score. Compare model, memory, condition, included accessories and quoted defects before prices.
Inputs: urls (required).
get_listingARead-onlyIdempotent
Read a full Avito listing URL: price, seller-declared condition, model/parameters, description, seller rating/type and quoted defect/mining/repair/testing mentions. No phone reveal, login, messaging or purchase. A visible listing may already be sold.
Inputs: url (required).
get_statusARead-onlyIdempotent
Local status: default city, saved browser session, request count and access cooldown. Does not contact Avito or disclose cookies, tokens or account data.
Inputs: no named parameters.
search_listingsARead-onlyIdempotent
Search Avito's computer-goods category, default Екатеринбург. Includes new/used/unknown.
Price window, sorting and seller filter are checked against the site's controls. Returns one site page (up to 50 listings), asking prices, links, seller ratings, snippet text and lexical hardware signals. local_only filters by listing URL city. total_found is BEFORE local filters. Use get_listing to confirm condition and health claims.
Inputs: query (required), city, page, sort, +5 more.
search_used_partsARead-onlyIdempotent
Find used PC parts by checking the actual condition in full listing cards.
One search plus up to 5 card reads (default 3). Only structured condition Б/у passes; new/unknown items are excluded and counted. Broken/repair items remain and carry text signals. This is a bounded scan of ONE page, not exhaustive or globally cheapest. Continue with next_offset on the SAME page, then next_page. Results can shift between calls.
Inputs: query (required), city, page, sort, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools have clearly distinct roles: get_listing reads one listing, compare_listings compares up to five, get_status reports local state. search_listings and search_used_parts overlap because both search Avito, but the specialized condition-filtered purpose of search_used_parts is explained well enough to reduce confusion.
Names consistently use snake_case with a leading verb (get_, search_, compare_), which is predictable. Minor deviations include singular/plural noun forms (get_listing vs search_listings) and the extra adjective in search_used_parts, but the pattern remains readable.
Five tools are well-scoped for a read-only Avito listing research server: general search, used-parts search, single-listing read, comparison, and local status. Each tool has a clear place and the set is neither thin nor bloated.
The surface covers the core read-only workflow: search listings, find used parts by condition, inspect a listing, compare exact listings, and check local status. Minor gaps remain, such as no dedicated seller/profile retrieval or category discovery, but agents can work around these via existing search and listing reads.
Related MCP Connectors
Real eBay sold prices for used GPUs, CPUs, RAM and more in 7 markets, and eBay listing price checks.
Search Bulgarian tech listings, real used prices per model, GPU FPS estimates and PC build checks.
Used prices for GPUs, CPUs, RAM, consoles, iPhones, MacBooks and more from live eBay listings.
Compare VPS/VDS, hosting plans of 2,000+ hosts and ready-made accounts across shops. Read-only.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA remote MCP server that searches Avito for new classified ads, filtering by price and returning only previously unseen listings. Designed for scheduled monitoring via ChatGPT tasks.-
- 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.7MIT
- 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