SkillFoxx

CLI and MCP for CIAN apartment search

Cian CLI

A Go CLI and MCP server for CIAN apartment search, with saved searches that track changes, favorites and price history

  • 0 ★ on the repository
  • Last commit
CLI

Extended access

Why this level

  • The CLI and MCP server read public CIAN listings over the network
  • Saved searches and favorites stay local, it never signs in to CIAN
All reasons and checks
Russian stack

samo33ddd/cian-cliAuthor:samo33ddd

Install

Services

Manual install

go build -o bin/cian-cli ./cmd/cian-cli && go build -o bin/cian-mcp ./cmd/cian-mcp

Builds the CLI and MCP server from Go source.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The CLI and MCP server read public CIAN listings over the network
  • Saved searches and favorites stay local, it never signs in to CIAN

This is third-party code. Review the repository files before installing.

What it does

The tool searches CIAN rental and sale listings by price, room count, district and metro without logging in, using public listings only. Saved searches are remembered locally and, on the next run, show new, changed, disappeared and returned listings. There are local favorite lists with apartment comparison, a metro station reachability estimate, and price history that this CLI itself has observed, not CIAN's full history. Every command supports an agent flag with compact JSON output for scripts and agents, and the cian-mcp binary exposes the same functionality as an MCP server over stdio or local HTTP. A separate SKILL.md documents instructions for an agent.

Who it is for. For people searching for an apartment on CIAN who want to track listing changes and compare options through an agent or CLI.

Good fit when

  • You want to save a search and see which listings are new, changed or gone since last time
  • You want to compare several shortlisted apartments by parameters and price history
  • You want an estimate of how close a listing is to the metro stations you need

Not a fit when

  • You need CIAN price history from before the CLI's first run: only what the CLI itself observed is saved
  • You need to manage an account or message listing owners: the CLI does not do this and only works with public data
  • The site has rate-limited requests or shown a CAPTCHA: bypassing protection is not supported, you should stop and retry later

Example request

Save a search for one-bedroom rentals up to 70000 rubles and show what changed since the last check

Limitations

The project has a single author, is unofficial and not affiliated with CIAN. It needs Go 1.26.6 or newer to build from source; the README does not directly mention ready binary releases. One search fetches a single page of results, up to 28 listings by default. Changing the data directory does not automatically migrate existing searches and favorites.

How to disable. Remove the cian entry from your MCP client config and, if needed, delete the CLI's data directory.

FAQ

Do I need to log into a CIAN account?

No, the CLI works with public listings without logging in and does not manage an account.

Does a listing disappearing from the results mean it was removed from the site?

No, one search only fetches a single page of results, so disappearing from that page does not prove the listing was removed site-wide.

Discussion

No questions or reviews yet.

All Cian tools

CIAN MCP server

CIAN MCP Server

Russian stack

An MCP server for searching Moscow apartment listings on CIAN: filters, price history and rental yield estimates

MCP serverExtended access
Russian stack

A local MCP server for apartment search on CIAN through a real, authorized browser session rather than bypassing the site's protection

MCP serverExtended access1
Russian stack

Watermark cleaning for photos for an agent: Avito and Cian profiles, automatic mark search and a custom mask, LaMa model run locally

MCP serverBroad access

An MCP server and CLI for SiYuan notes with notebook-level permissions, rollback of agent edits and a document timeline.

MCP serverExtended access123

Jira MCP in Go: an agent searches issues by JQL, runs sprints, comments and worklogs and sees an issue's branches and pull requests on Cloud and Server

MCP serverBroad access96

README in short

The Russian README covers features, building from Go source, a quick search start, working with saved searches, favorites and price history, connecting the MCP server over stdio or HTTP, configuring data directories via environment variables, and a limitations section: the site may rate-limit or show a CAPTCHA, and bypassing it is not supported. Development and checks via make check are described separately.

README badge

Report a problem