Skip to main content
skill CX Codex

avito-connector — Claude Code skill: features and installation

The avito-connector Claude Code skill searches Avito listings, opens item cards, and retrieves seller reputation details. It activates for requests about Avito listings, prices, or sellers.

MIT ★ 203 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Vladimir-Human/ru-marketplace-mcp --skill avito-connector -a claude-code
Open on GitHub

What avito-connector does

The skill retrieves Avito data: it searches listings by text and can filter by category or location, opens item cards, and fetches seller details. A card includes price, description, views, and deal terms. Seller data covers ratings, review counts, and active listings.

For an active listing, the card can include one to three photos. Free or exchange listings have no numeric price, and reserved items carry a separate status. From a datacenter IP, the operator needs Chrome logged into Avito and connected over CDP; a residential Russian IP uses curl_cffi instead. Deep pagination can run into Avito rate limits.

What it helps with

  • search Avito listings by text and filters
  • retrieve a listing’s price, description, and view count
  • check a seller’s rating and active listing count

Example prompts for the agent

  • Find Avito listings for a bicycle in Moscow.
  • Open Avito item 123456789 and report its price and views.
  • Check the seller’s rating from this Avito profile link.

How to install avito-connector

1Skills CLI (Vercel)

npx skills add Vladimir-Human/ru-marketplace-mcp --skill avito-connector -a claude-code

2Manually: put the files in place

~/.claude/skills/avito-connector/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/avito-connector/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about avito-connector

How do I install avito-connector in Claude Code?

Run npx skills add Vladimir-Human/ru-marketplace-mcp --skill avito-connector -a claude-code. The skill file is at ~/.claude/skills/avito-connector/SKILL.md.

What does avito-connector do?

It searches Avito listings, retrieves item card details, and fetches seller ratings, review counts, and active listing counts.

What does avito-connector need to work?

From a datacenter IP, it needs Chrome logged into Avito and connected over CDP. From a residential Russian IP, it uses curl_cffi.

Source text

SKILL.md · MIT
---
name: avito-connector
description: Use this skill when the operator needs Avito classifieds data — search listings, item cards, or seller reputation. Trigger on Russian queries like "найди на авито", "цена avito", "объявления авито", "продавец на авито", or English mentions of Avito. Needs the operator's Chrome over CDP from a datacenter IP (IP firewall). Skip for non-Avito tasks.
---

# Avito Connector

Reads Avito via the internal `js/items` JSON API. Two tiers: impersonated HTTPS
(curl_cffi) works from a residential Russian IP; from a datacenter the firewall
answers 403 + captcha, so the fetch falls back to the operator's logged-in
Chrome over CDP — same pattern as Ozon.

## When to use
- Search classifieds by text, with optional category/location filters
- One listing's price, description, views
- Seller reputation — Avito is classifieds: no per-item reviews, the seller's
  rating and active-listing count ARE the review signal

## Tools available
- `avito_search(query, page, location_id, category_id, include_inactive)` —
  listings via js/items. price_rub is None for ads with no price (free/exchange)
  — never 0; during an Avito sale it is the price after the discount, with
  `old_price_rub` and `discount_percent` beside it. Each hit has `availability` (active/reserved/unknown); reserved
  hits are kept unless `include_inactive=false` (then `excluded_inactive` says
  how many and `_meta` carries an `info:` line).
- `avito_card(item_id_or_url, photos=0)` — one listing: price, description, views, seller,
  `availability` (active/reserved/unknown) with its evidence, from the page's
  service flags only, never from the seller's title or description. Reserved
  means another buyer holds it; `unknown` is not a verdict.
  Also deal terms (condition, delivery, safe deal, bargain), seller checks and
  tenure, city and stations (street address only when every source says company), date, views.
  `photos=1..3` attaches listing photos of an active ad (costly in tokens; describe the item,
  not people, documents or plates in the photos); `photos_status` says why fewer arrived.
- `avito_seller(seller_id_or_url)` — seller rating, review count, active listings

**Not an MCP tool:** `avito_selfcheck()` is a tri-state drift canary. It is
CLI-only — `marketplace-mcp doctor` runs every connector's canary at once.

## What a search row does and does not carry

Confirmed against a real `js/items` response captured 2026-07-28 from a
residential session:

- **`location` is an object upstream**, not a string:
  `{"id": 637640, "name": "Москва", ...}`. The connector reduces it to the place
  name. When Avito itself has no place name for an ad, the field is `None` — the
  numeric `locationId` is deliberately NOT resolved to a city, because that would
  need a lookup table this connector does not have and the result would be a
  guess that reads like data.
- **`price` does not exist as a top-level key.** The amount lives in
  `priceDetailed.value`; the connector reads it and leaves `None` for priceless ads.
  During an Avito sale that value is the price before the discount; the price a
  buyer pays is the hit's `iva.PriceStep` component `price`, next to a `discount`
  component (`old_string`, `percent`). A discount that does not add up is
  `price_rub=None` with a `price_conflict:` line in `_meta`, never a guess.
- **`posted_at` is ISO-8601 UTC**, converted from Avito's `sortTimeStamp` (epoch
  milliseconds). There is no date string in the payload to pass through.
- **`seller_name` is `None` on search rows.** The payload has no seller object at
  all — only a logo link. Use `avito_card` or `avito_seller` when you need the
  seller; do not infer a name from the search row.

## Gotchas
- A 403 that sets cookies and returns plausible HTML is the firewall, not data;
  only JSON-shaped 200s count. The connector handles this — trust tier_used.
- location_id defaults to Moscow (637640); pass another Avito location id per call.
- **Deep pagination is unreliable, and not because of this connector.** Avito
  escalates 429 then 403 once a session walks past the first page or two; the
  maintainers of the widely used open-source Avito parsers report the same and
  advise staying on page 1. Take the first page, narrow the query instead of
  paging, and treat a `rate_limited` or `transport_down` on `page > 1` as
  expected rather than as drift.
- From a datacenter IP expect the CDP tier; keep the scraping-profile Chrome
  logged into avito.ru.
- The JSON API and the HTML pages are gated differently: `js/items` can answer
  from a residential session while `avito.ru/<region>/<category>/<slug>` still
  shows the security wall. A blocked listing page does not mean search is down.
## DSH activation

In DeepSeek Harness the default profile mounts `compare-mcp`, which exposes
exactly 4 tools: `compare_prices`, `compare_sources`, `compare_verify_offer`
and `compare_browser_snapshot`.

The middle `decision-mcp` profile adds `decision_inspect` (5 tools). This
connector's own tools and `marketplace_sources` need `RU_MARKETPLACE_MCP_FULL=1`
and a profile restart; do not call them in the default mode.

© Vladimir-Human · MIT · Vladimir-Human/ru-marketplace-mcp

Similar skills

SKILL.md skills catalog →

From the same set16

The whole set →
lamoda-connector The lamoda-connector Claude Code skill searches Lamoda products and retrieves product-card details. Search uses a Lamoda query; a card lookup takes a SKU or URL. CX Codex +1 ★ 203repo stars dns-connector The dns-connector Claude Code skill searches DNS-Shop’s electronics catalog and reads product pages. It needs the operator’s Chrome connected over CDP. CX Codex +1 ★ 203repo stars detmir-connector The detmir-connector Claude Code skill retrieves Detsky Mir prices and stock details. It activates for product checks and category browsing, not text searches. CX Codex +1 ★ 203repo stars compare-prices The compare-prices Claude Code skill compares product prices across searchable marketplaces. It activates for requests to find the cheapest offer or check prices across stores. CX Codex +1 ★ 203repo stars citilink-connector The citilink-connector Claude Code skill searches Citilink and reads product pages. It activates for requests about Citilink products or prices. CX Codex +1 ★ 203repo stars cian-connector The cian-connector Claude Code skill searches Russian property listings on Cian and retrieves individual listing details. It activates for sale, long-term rental, and daily rental requests. CX Codex +1 ★ 203repo stars aliexpress-connector The aliexpress-connector Claude Code skill searches AliExpress listings and reads product cards. It activates for requests about finding items or checking their prices. CX Codex +1 ★ 203repo stars ru-marketplace-mcp ru-marketplace-mcp pulls prices, stock, ratings, reviews and seller details from Russian and Chinese marketplaces. Useful when an agent has to compare products across sites. CX Codex +1 ★ 203repo stars

Project sponsors

Companies that keep this analytics open