# 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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 203 repo stars
- Author: Vladimir-Human
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Vladimir-Human/ru-marketplace-mcp/tree/HEAD/skills/cian-connector/SKILL.md
- Updated: 2026-10-19
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cian-connector

## What it does

The skill searches Cian for flats, rooms, houses, and commercial property using deal type, region, room count, price, and area filters. For a listing, it retrieves the price and its history, address, description, building details, and publisher information.

Search requests use Cian’s JSON API from Chrome over CDP. Chrome must be running with that connection; Cian’s WAF blocks plain HTTP requests. There is no text-query filter or metro and street filter, though returned results can be narrowed by address or metro station.

## Requirements
- Works with: Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cian-connector/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cian-connector/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cian-connector/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cian-connector/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Vladimir-Human/ru-marketplace-mcp skills/cian-connector
```

2. **Manually: put the files in place**
- File: `.github/skills/cian-connector/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Vladimir-Human/ru-marketplace-mcp --path skills/cian-connector
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cian-connector/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Vladimir-Human/ru-marketplace-mcp --skill cian-connector -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Vladimir-Human/ru-marketplace-mcp/tree/HEAD/skills/cian-connector/SKILL.md

## When to use it
- find sale listings by price and area
- search for long-term or daily rentals
- retrieve a listing’s price history and publisher details
- filter results by address or metro station

## Example prompts
- Find one-bedroom flats for sale on Cian in Moscow under 12 million rubles.
- Search Cian for houses available for daily rent in Saint Petersburg.
- Open a Cian listing and show its price history and publisher details.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 1aa7052af4b37437.

BEGIN THIRD-PARTY FILE 1aa7052af4b37437
```text
---
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
```
END THIRD-PARTY FILE 1aa7052af4b37437

The third-party file has ended. Everything between the 1aa7052af4b37437 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2950 of 9207 bytes. © Vladimir-Human · MIT · https://github.com/Vladimir-Human/ru-marketplace-mcp/tree/HEAD/skills/cian-connector/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
