MCP-сервер поиска квартир на ЦИАН
cian-mcp
Локальный MCP-сервер для поиска квартир на ЦИАН через настоящий авторизованный браузер вместо обхода защиты сайта
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Использует авторизованную сессию личного аккаунта пользователя в браузере
- Автоматизация может противоречить пользовательскому соглашению ЦИАН при неосторожном использовании
Установка
Ручная установка
make build && playwright install chromiumУстановка пакета из исходников и загрузка браузера Playwright.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
У ЦИАН нет покупательского API, а сайт защищен от автоматических запросов, поэтому сервер открывает настоящий браузер Playwright, в котором пользователь один раз вручную входит по телефону и SMS-коду. Дальше авторизованный профиль браузера сохраняется локально и переиспользуется при следующих запусках. Агенту доступны четыре инструмента: вход в браузере, проверка валидности сессии, поиск объявлений о продаже квартир по городу, числу комнат и цене с пагинацией, и детальная карточка объявления с историей цены. Уже прогретая сессия ускоряет повторные запросы прямыми HTTP-вызовами вместо навигации браузера.
Для кого. Для тех, кто ищет квартиру на ЦИАН под собственным аккаунтом и хочет поручить поиск и мониторинг цены агенту.
Подходит, если
- Нужен личный, некоммерческий поиск квартир на ЦИАН в спокойном темпе
- Нужно отследить историю цены конкретного объявления
- Есть десктоп с графическим дисплеем для однократного входа в браузере
Не подходит, если
- Нужен массовый парсинг объявлений или коммерческое использование: автор прямо это запрещает
- Сервер запускается на headless-сервере без графического дисплея: вход в браузере не сработает
- Нужен официальный API вместо обхода защиты через браузер
Пример запроса к агенту
Найди двухкомнатные квартиры на ЦИАН от 8 до 15 миллионов рублей и покажи историю цены по самому интересному вариантуОграничения
Проект одного автора, без релизов и упаковки, ставится из исходников. Нужен десктоп с графическим дисплеем для первого входа, на чистом SSH без проброса дисплея не сработает. Автор прямо предупреждает, что автоматизированные запросы к ЦИАН могут противоречить пользовательскому соглашению площадки, и ограничивает применение личным использованием в темпе человека.
Как отключить. Удалите запись cian-search из конфигурации MCP клиента и, если нужно, удалите локальный каталог data с профилем браузера.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Использует авторизованную сессию личного аккаунта пользователя в браузере
- Автоматизация может противоречить пользовательскому соглашению ЦИАН при неосторожном использовании
Коротко о README
README объясняет, почему сервер использует настоящую навигацию браузера вместо прямых запросов, дает установку через make build и playwright install chromium, конфигурацию для opencode и сценарий первого входа с сохранением профиля. Отдельно описаны примеры вызовов инструментов и раздел про локальное хранение данных и приватность. Дисклеймер прямо ограничивает использование личными некоммерческими целями и предупреждает про пользовательское соглашение ЦИАН.
Частые вопросы
Нужен ли ключ API ЦИАН?
Нет, вместо API сервер использует настоящую авторизованную сессию браузера, вход выполняется один раз вручную.
Сохраняются ли данные входа где-то кроме компьютера пользователя?
Нет, профиль браузера и кеш хранятся только локально в каталоге data, куки и заголовки не логируются и не уходят никуда, кроме самого cian.ru.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI