К основному содержанию
скилл CX Codex

cian-connector — скилл для Claude Code: поиск на Циан

Скилл cian-connector для Claude Code ищет российскую недвижимость на Циан и открывает карточки объявлений. Запускается на запросы о продаже, долгосрочной или посуточной аренде.

MIT ★ 203 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a claude-code
Открыть на GitHub

Что делает cian-connector

Скилл ищет на Циан квартиры, комнаты, дома и коммерческую недвижимость по типу сделки, региону, числу комнат, цене и площади. Для одного объявления он возвращает цену и историю её изменений, адрес, описание, параметры дома и сведения о продавце.

Поиск идёт через JSON API Циан внутри Chrome, подключённого по CDP. Нужен запущенный Chrome с таким подключением: обычный HTTP-запрос блокирует WAF сайта. Текстовый поиск, фильтры по метро и улице не поддерживаются; результаты можно отбирать по адресу и станции метро.

Какие задачи решает

  • найти объявления о продаже по цене и площади
  • подобрать жильё для долгосрочной или посуточной аренды
  • получить историю цены и данные продавца по объявлению
  • отфильтровать результаты по адресу или станции метро

Примеры запросов агенту

  • Найди на Циан однокомнатные квартиры в Москве до 12 миллионов рублей.
  • Подбери дома для посуточной аренды в Санкт-Петербурге.
  • Открой карточку объявления на Циан и покажи историю цены и данные продавца.

Как установить cian-connector

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/cian-connector/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cian-connector

Как установить cian-connector в Claude Code?

Выполни npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a claude-code. Файл скилла находится по пути ~/.claude/skills/cian-connector/SKILL.md.

Что делает cian-connector?

Ищет объявления на Циан по типу сделки и параметрам недвижимости, а также получает данные отдельной карточки, включая историю цены и сведения о продавце.

Что нужно для работы cian-connector?

Нужен запущенный Chrome, подключённый по CDP. Обычные HTTP-запросы Циан блокирует.

Исходный текст

SKILL.md · MIT
---
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. The connector knows only the four
below (`KNOWN_REGIONS`, used in error messages); any other id must come from cian.ru.
Known and verified live:

| id   | region                |
|------|-----------------------|
| 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.

## 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 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. Cian is never part of the compare mount,
so it is only reachable in the full profile. In standard MCP clients (Claude,
Cursor, Codex, Gemini CLI, OpenCode), Cian tools require mounting the unified
`marketplace-mcp` server (`--profile full`, configured by default in `.mcp.json`
and `gemini-extension.json`) or the standalone `cian-mcp` server — they are not
exposed by `compare-mcp` or `decision-mcp`.

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

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →
agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок baoyu-post-to-x JimLiu Скилл baoyu-post-to-x публикует текст, картинки, видео и длинные статьи в X через браузер Chrome. Работает через плагин Codex, Computer Use или CDP-скрипты. CX Codex +1 29 500установок baoyu-post-to-weibo JimLiu Скилл baoyu-post-to-weibo готовит обычные публикации и статьи для Weibo через Chrome. После заполнения формы пользователь сам проверяет запись и публикует её. CX Codex +1 22 200установок remote-browser browser-use Скилл remote-browser для Claude Code управляет изолированным браузером Browser Use Cloud через CLI. Он включается, когда агенту нужен браузер, а локальный Chrome недоступен. CX Codex +1 5 000установок chrome-cdp pasky Скилл chrome-cdp для Claude Code подключает ИИ-агента к запущенному Chrome через протокол DevTools без Puppeteer. Используется для отладки вёрстки, снятия скриншотов и кликов по элементам. CX Codex +1 2 200установок chrome-cdp-live-browser reason-machines Скилл chrome-cdp-live-browser подключает агента к уже открытому Chrome по Chrome DevTools Protocol. Работает с вашими вкладками, логинами и текущим состоянием страницы. CX Codex +1 1 500установок

Из того же набора16

Весь набор →
lamoda-connector Скилл lamoda-connector для Claude Code ищет товары Lamoda и извлекает сведения из карточки. Поиск запускается по запросу о Lamoda, а карточка товара — по SKU или ссылке. CX Codex +1 ★ 203звёзд репо dns-connector Скилл dns-connector для Claude Code ищет электронику в каталоге DNS-Shop и открывает карточку товара. Для работы нужен Chrome оператора, подключённый через CDP. CX Codex +1 ★ 203звёзд репо detmir-connector Скилл detmir-connector для Claude Code получает цены и данные о наличии товаров из «Детского мира». Он включается для проверки товара или просмотра категории, но не для текстового поиска. CX Codex +1 ★ 203звёзд репо compare-prices Скилл compare-prices для Claude Code сравнивает цены на товар в поисковых источниках маркетплейсов. Запускается на запросы вроде «где дешевле» и «найди самую низкую цену». CX Codex +1 ★ 203звёзд репо citilink-connector Скилл citilink-connector для Claude Code ищет товары на Citilink и открывает карточки с ценами. Запускается на запросы о товарах и ценах Citilink. CX Codex +1 ★ 203звёзд репо avito-connector Скилл avito-connector для Claude Code ищет объявления Avito, открывает карточки товаров и проверяет репутацию продавцов. Запускается на запросы о поиске, цене или продавце на Avito. CX Codex +1 ★ 203звёзд репо aliexpress-connector Скилл aliexpress-connector для Claude Code ищет товары на AliExpress и читает карточки. Запускается по запросам о товарах и ценах на этой площадке. CX Codex +1 ★ 203звёзд репо ru-marketplace-mcp MCP-сервер ru-marketplace-mcp для Claude Code и Codex. Читает цены, наличие, рейтинги, отзывы и реквизиты продавцов с российских и китайских маркетплейсов. Сравнивает товары по площадкам одним запросом. CX Codex +1 ★ 203звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой