Agent skill

Cian Connector

by Vladimir-Human in Vladimir-Human/ru-marketplace-mcp

A skill your agent uses when the operator needs Russian real-estate data from Cian (cian.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card…

MITAuto-check passedBusiness, Finance & HR

Install Cian Connector

skills CLI
$ npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Vladimir-Human/ru-marketplace-mcp cian-connector --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Vladimir-Human/ru-marketplace-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cian-connector .claude/skills/cian-connector && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cian-connector
GitHub stars
141
Token cost
~2.1k tokens
SKILL.md length
1,125 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the operator needs Russian real-estate data from Cian (cian.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card…

  • The operator needs Russian real-estate data from Cian (cian.ru) — flats
  • SKILL.md covers When to use, Tools available, Region is an id, not a name and Filters: what the search does…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Commercial property for sale

What it does

Cian Connector is an agent skill from Vladimir-Human/ru-marketplace-mcp. Use this skill when the operator needs Russian real-estate data from Cian (cian.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card with price history and publisher. Trigger on Russian queries like "найди на циане", "квартира на циан", "снять квартиру", "снять посуточно", "квартира на сутки", "купить однушку в Москве", "сколько стоит квартира на", "объявление циан", or English mentions of Cian. Needs the operator's Chrome over CDP (Cian's WAF blocks plain…

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Real estate. The repository describes itself as: Одиннадцать маркетплейсов и недвижимость Циан как MCP-серверы: Wildberries, Ozon, Яндекс Маркет, Детский мир, Авито, AliExpress, Taobao, Мегамаркет, Lamoda, DNS, Ситилинк, Циан… The licence is MIT.

When your agent uses it

  • The operator needs Russian real-estate data from Cian (cian.ru) — flats
  • Commercial property for sale
  • One offers card with price history and publisher
  • Russian queries like найди на циане

Example prompts

  • “s Chrome over CDP (Cian”
  • “/cian-connector”

What it can do on your machine

Read from SKILL.md and the folder at commit c17bd36. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cian Connector loads about 2.1k tokens when it runs. Until then it costs about 150 tokens; SKILL.md has 1,125 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Vladimir-Human/ru-marketplace-mcp at commit c17bd36, republished under its MIT licence (© Vladimir-Human). 1,125 words, ~2,075 tokens.

Download SKILL.mdSave it as .claude/skills/cian-connector/SKILL.md (or your agent's skills folder).
name
cian-connector
description
Use this skill when the operator needs Russian real-estate data from Cian (cian.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card with price history and publisher. Trigger on Russian queries like "найди на циане", "квартира на циан", "снять квартиру", "снять посуточно", "квартира на сутки", "купить однушку в Москве", "сколько стоит квартира на", "объявление циан", or English mentions of Cian. Needs the operator's Chrome over CDP (Cian's WAF blocks plain HTTP by IP). Skip for goods, marketplaces, and non-Cian real estate.

Cian Connector

Reads Cian through the site's own JSON API, called from inside the operator's Chrome over CDP: the search endpoint answers an in-page POST, and the offer card embeds its whole state in window._cianConfig. No HTML is parsed. Plain HTTP is blocked by Cian's WAF on IP reputation (a 403 «Обнаружен подозрительный трафик» page, no captcha), so there is no anonymous tier.

When to use

  • Find offers by filters: deal (sale / long-term rent / daily rent), property type, region, rooms, price range, total area
  • One offer's price, its price history, layout, building, address, metro, description and publisher
  • Real estate only. For goods use the marketplace connectors; for price comparison across shops use compare_prices — Cian takes no part in it

Tools available

  • cian_search(deal, offer_type="flat", region=None, rooms=None, price_min=None, price_max=None, area_min=None, area_max=None, page=1) — offers via search-offers-desktop, 28 per page. deal is sale, rent (long-term) or daily (посуточно); offer_type is flat, room, house or commercial. price_rub is None for an offer without a stated price — never 0, and price_unit says what it buys.
  • cian_card(offer_id_or_url) — one offer: price, price_history, rooms, areas, floor, building, address, metro[], description, views, agent.

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

Region is an id, not a name

Cian addresses regions by its own numeric ids and the connector has no lookup table. Known and verified live:

idregion
1Москва
2Санкт-Петербург
4593Московская область
4588Ленинградская область

Anything else needs the Cian id (visible as region= in a cian.ru search URL). Do not guess an id: a wrong one returns another region's offers with correct-looking prices. Default is CIAN_REGION (1, Moscow).

Filters: what the search does and does not do

  • No text search. There is no query string; "двушка у метро Сокол" has to become rooms=[2] plus a region and a price range. Metro and street filters are not exposed; filter the returned rows by address / metro yourself.
  • rooms applies to flats only: any of 1–6, plus Cian's codes 7 (свободная планировка) and 9 (студия) — verified live, and easy to get backwards. Rooms (offer_type="room") are searched as flats with Cian's room code 0 — the caller's rooms is ignored there.
  • price_min / price_max are rubles, in whatever unit the deal implies: total for sale, per month for rent, per night for daily.
  • total_count is Cian's aggregatedCount — the de-duplicated figure the site shows, usually below the raw offerCount.

Long-term and daily are two markets, never one page

deal="rent" and deal="daily" are separate on Cian and the connector keeps them separate (for_day "!1" vs "1"). Measured live in Moscow on 2026-09-10: 25 411 long-term flats, 53 441 daily ones, and dropping the flag entirely returns a mixture, which is why the connector never does.

  • A daily price is per night. price_unit is "day", and the category comes back as dailyFlatRent / dailyRoomRent / dailyHouseRent. Cian leaves price_period and lease_term null there, so price_unit is the only honest signal — do not rank a 5 000 ₽ night against a 90 000 ₽ month.
  • Daily covers flat, room and house only. offer_type="commercial" with deal="daily" is refused as a bad request: Cian accepts that query upstream and answers zero, which would read as "nothing free today" rather than "this market does not exist".
  • For a stay of about a month, both markets are worth a look: long-term with lease_term == "fewMonths" (снять на несколько месяцев), and daily where a monthly discount is usually negotiated in the description rather than published as a field.
Show full SKILL.md (549 more words)Show less

What a row carries and how to read it

Confirmed against live payloads captured 2026-09-09 (fixtures in the package):

  • Price comes from bargainTerms.priceRur, then bargainTerms.price, then priceTotalRur. A new-building card has only the latter two, and a daily offer has no priceRur at all — the parser reads all three, so a null price means Cian shows none, not a missed key.
  • price_unit is computed by the connector, not Cian: total, month or day. Quote it whenever you show a price, and never average across units.
  • title is Cian's own only on some offers; otherwise the short info line ("1-комн.кв. · 12/22 этаж") or a composed "rooms, area, floor" stands in. Do not treat the title as a marketing name.
  • metro on a search row is the station Cian marks as the tile's own (isDefault), not the shortest travel time — a 7-minute bus ride does not outrank a 10-minute walk. The card returns every station in that order, with mode walk or transport.
  • category tells the market: newBuildingFlatSale is a developer's primary offer (agent.user_type = developer, saleType fz214), flatSale is resale, roomSale, houseSale, officeSale and friends for the rest.
  • Long-term rent rows add price_period (monthly), lease_term (longTerm / fewMonths) and deposit_rub. is_by_homeowner is True only when the owner publishes without an agent; None means Cian did not say.
  • created_at is Cian's local ISO time without a zone; updated_at on the card is UTC. Do not compare them as if they were in one zone.
  • views on the card is parsed from Cian's own text («12907 просмотров, 98 за сегодня»): the first number, total views.

What the source cannot do (and the connector does not pretend)

  • No agent/agency tool: /agents/<id>/ renders profile facts only as page text, with no structured state, so no tool reads it. The publisher's name, type, id, offer count and account age ship inside the card's agent field.
  • No reviews — real estate has no per-offer review pool.
  • No geo-suggest: regions and metro are ids, not names (see above).
  • No phone numbers: the card knows how many phones the offer has, not their values.

Gotchas

  • 403 inside the browser session (transport_down with "WAF block") means Cian challenged the scraping profile: open cian.ru in that Chrome, pass the check if one is shown, retry. From a datacenter IP a cold session can start blocked; a warmed-up session answered 8 requests in a row with no 429.
  • Pace is deliberate: 1.5 s between requests, one tab at a time. Do not hammer pages 1–10 in a loop; ask for what is needed.
  • parser_drift means the envelope or _cianConfig shape changed — the connector will not hand back a half-parsed card as if it were data. Run the canary, then fix the parser.
  • A removed offer may render as "объявление не найдено" → not_found.
  • Verification story: a green selfcheck proves the transport answered and the parser found ids, prices and addresses. It does not prove a particular price is current — Cian's price_history on the card is the evidence to quote when it matters.

DSH activation

In DeepSeek Harness, the default profile exposes only compare_prices and compare_sources through the cheap compare mount. Per-marketplace tools and marketplace_sources require RU_MARKETPLACE_MCP_FULL=1 and a profile restart; do not call them in the default mode. Cian is never part of the compare mount, so it is only reachable in the full profile.

© Vladimir-Human, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cian-connector of Vladimir-Human/ru-marketplace-mcp.

Open the folder on GitHubat commit c17bd36

Compare with similar skills

Cian Connector next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cian Connector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cian Connector this skillVladimir-Human/ru-marketplace-mcp141—~2.1kAutomated safety check: PassMIT
Thue Tncn Vietnamdotanminh/thue-tncn-vietnam241—~2.8kAutomated safety check: PassNone
Apartment Finderhanzili/hanzi-browse177—~2.1kAutomated safety check: PassCustom licence
Realestate Commercialzubair-trabzada/ai-realestate-claude179—~3.2kAutomated safety check: PassMIT
Vet PRetewiah/awesome-real-estate375—~1.5kAutomated safety check: PassCC0-1.0
Realestate Comparezubair-trabzada/ai-realestate-claude179—~3.7kAutomated safety check: PassMIT

Similar skills

  • Thue Tncn Vietnam

    dotanminh/thue-tncn-vietnam

    A skill your agent uses when user asks about Vietnamese personal income tax (TNCN), tax finalization (quyet toan), dependent deductions (giam tru gia canh), freelancer/KOL/online seller tax, eTax…

    241 GitHub stars~2.8k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed
  • Apartment Finder

    hanzili/hanzi-browse

    Search for apartments across multiple real estate platforms, compare listings side by side, and help submit inquiries or applications.

    177 GitHub stars~2.1k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Realestate Commercial

    zubair-trabzada/ai-realestate-claude

    Commercial Property Analysis — NOI, cap rate, expense ratio, tenant mix, vacancy, debt coverage, replacement cost, and lease analysis with Commercial Score (0-100)

    179 GitHub stars~3.2k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Vet PR

    etewiah/awesome-real-estate

    Rigorous checklist for triaging PRs on the awesome-real-estate list.

    375 GitHub stars~1.5k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Realestate Compare

    zubair-trabzada/ai-realestate-claude

    Side-by-Side Property Comparison — takes two addresses and compares across price, specs, rental income, neighborhood, and investment potential with a winner per category and overall recommendation

    179 GitHub stars~3.7k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Taichung Land Parcel Query

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when an architect receives just an address or lot number (地號) for a site in Taichung City, Taiwan, and needs the land's basic data — zoning, registered land area, land…

    158 GitHub stars~1.9k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed

More from Vladimir-Human/ru-marketplace-mcp

All 12 skills in this repo
  • Citilink Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Citilink electronics data — search or a product card.

    141 GitHub stars~927 tokensUpdated 6 days ago
    Auto-check passed
  • Mpstats Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses for MPStats sales/stock analytics on a specific Ozon or Wildberries item — per-day sales, current price and stock, FBS/FBO warehouse split, seller/brand identity, and a…

    141 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Aliexpress Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator asks to search AliExpress or read one of its product cards.

    141 GitHub stars~1.2k tokensUpdated 6 days ago
    Auto-check passed
  • Avito Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Avito classifieds data — search listings, item cards, or seller reputation.

    141 GitHub stars~950 tokensUpdated 6 days ago
    Auto-check passed
  • Compare Prices

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator asks where something is cheapest across marketplaces.

    141 GitHub stars~2.5k tokensUpdated 6 days ago
    Auto-check passed
  • Detmir Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Detsky Mir data — prices and availability for kids' and baby goods, toys, strollers, nappies, kids' clothing.

    141 GitHub stars~1.2k tokensUpdated 6 days ago
    Auto-check passed

Questions about Cian Connector

What does Cian Connector do?

A skill your agent uses when the operator needs Russian real-estate data from Cian (cian.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card…. Cian Connector is an agent skill from Vladimir-Human/ru-marketplace-mcp.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card with price history and publisher.

When should I use Cian Connector?

Cian Connector fits situations like: the operator needs Russian real-estate data from Cian (cian.ru) — flats; commercial property for sale; one offers card with price history and publisher; russian queries like найди на циане.

How do I install Cian Connector in Claude Code?

Run `npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a claude-code`. Or copy the skill folder (skills/cian-connector in Vladimir-Human/ru-marketplace-mcp) into .claude/skills/cian-connector in your project. Claude Code loads it when a task matches its description.

How do I install Cian Connector in Codex?

Run `npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a codex`. Or copy the skill folder (skills/cian-connector in Vladimir-Human/ru-marketplace-mcp) into .agents/skills/cian-connector in your project. Codex loads it when a task matches its description.

Can I use Cian Connector in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cian-connector, .gemini/skills/cian-connector, .github/skills/cian-connector and .opencode/skills/cian-connector in your project.

What does Cian Connector need to run?

SKILL.md names no scripts, command-line tools or credentials: Cian Connector is instructions for the agent only.

Does Cian Connector access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cian Connector safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cian Connector use?

Cian Connector is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cian Connector use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cian Connector?

Skills that share tags, products or a category with Cian Connector: Thue Tncn Vietnam (dotanminh/thue-tncn-vietnam, 241 stars), Apartment Finder (hanzili/hanzi-browse, 177 stars), Realestate Commercial (zubair-trabzada/ai-realestate-claude, 179 stars) and Vet PR (etewiah/awesome-real-estate, 375 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cian Connector?

Vladimir-Human (a GitHub user) maintains it in Vladimir-Human/ru-marketplace-mcp, which has 141 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 5, 2026.

Source: Vladimir-Human/ru-marketplace-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.