DomXML
REST API · MCP · OAuth 2.1 · Бесплатно

Управляйте шахматкой из кода и нейросетей

Подключите Claude, ChatGPT или свою CRM к DomXML: MCP-сервер с 74 инструментами и REST API дают полный доступ к квартирам, коммерции, машиноместам, участкам и домам, ценам, статусам и фидам. «Подними цены на 5% в корпусе 2» — и готово.

Подключить бесплатно Документация MCP Документация API

Без тарифов. Лимит запросов — только у публичного API для сайтов

Чат с нейросетью
DomXML подключён https://domxml.ru/mcp

Подними на 5% цены свободных двушек в корпусе 1

Инструмент DomXML · list_apartments

{"complex_id": 5627431, "building": "Корпус 1", "rooms": 2, "status": "available"}

→ 12 объектов

Инструмент DomXML · bulk_update_price

{"complex_id": 5627431, "apartment_ids": [81204, 81208, 81223, …], "percent": 5}

{"ok": true, "updated": 12, "next_action": "generate_feed для площадок"}

Готово: цены 12 свободных двухкомнатных квартир в корпусе 1 подняты на 5%. Например, №31 — было 7 580 000 ₽, стало 7 959 000 ₽.

Фиды обновятся сами в течение 3 часов. Пересобрать фид Домклик сейчас?

Напишите сообщение…
1

Запрос обычными словами

Номера квартир и поля знать не нужно: нейросеть сама решит, что искать.

2

Инструменты DomXML

Нейросеть вызывает инструменты MCP — здесь list_apartments находит свободные двушки корпуса.

3

Одним вызовом

bulk_update_price ставит всем одну цену или меняет её на процент — до 500 квартир за раз, с записью в журнал ЖК.

4

Итог в ответе

Сколько квартир изменено и что дальше: фиды обновятся сами в течение 3 часов или сразу — через generate_feed.

Подключение одним адресом

Нейросети достаточно дать один адрес

https://domxml.ru/mcp
1

Вставьте адрес в клиент

В Claude — «Add custom connector», в ChatGPT — коннектор в Developer Mode, в редакторах — строка в конфиге.

2

Войдите в DomXML

Клиент сам откроет окно подтверждения — OAuth 2.1 с автоматической регистрацией, никаких ключей копировать не нужно.

3

Выберите ЖК и доступ

Все ЖК или конкретные, уровень «чтение» или «редактирование», срок действия — вы контролируете границы.

4

Работайте в чате

Нейросеть видит шахматку и меняет её по вашим командам. Подключение отображается в панели и отзывается в один клик.

Альтернатива для редакторов кода и скриптов — API-ключ dxk_… из раздела «API и MCP» в панели.

Сценарии

Просто напишите, что нужно сделать

«Подними цены на 5% на однокомнатные квартиры в корпусе 2»

Нейросеть найдёт нужные квартиры и массово изменит цены одним вызовом — до 500 квартир за раз.

«Отметь квартиры 45–52 проданными и пересобери фид Домклик»

Смена статусов и обновление фида — за одно сообщение. Площадка заберёт свежие данные по постоянной ссылке.

«Сколько свободных двушек осталось в каждом корпусе?»

Аналитика по шахматке без выгрузок: остатки, статистика по статусам, сравнение корпусов — прямо в чате.

«Заведи в посёлке участки 21–30 на улице Лесной, по 12 соток, ИЖС, 160 тысяч за сотку»

Нейросеть создаст участки с площадью в сотках, ВРИ, улицей и ценой — дальше их останется обвести на генплане.

«Добавь 20 машиномест на −1 уровне по 1,5 млн»

Машиноместа появятся в шахматке рядом с квартирами, на уровне −1. На площадки они уйдут в фидах, где отмечено нежилое, — или в отдельном фиде только с машиноместами.

«Добавь проект „Барн 120“: коробка 4,5 млн, под ключ 9 млн, участок от 6 соток»

Проект попадёт в каталог посёлка, и на витрине у подходящих участков появится цена «участок + дом».

Правки ЖК и объектов попадают в журнал ЖК с пометкой «Нейросеть» — видно, кто, когда и что поменял.

MCP-сервер

74 инструмента для шахматки, импорта, посёлков, CRM, витрины, квизов и агентов

Все инструменты работают по API-ключу dxk_… или подключению по OAuth, в пределах уровня доступа и списка ЖК. Удаляющих инструментов нет.

whoami

Кто подключён: email, уровень доступа, доступные ЖК

list_complexes

Доступные жилые комплексы и коттеджные посёлки

get_complex

ЖК или посёлок: корпуса и очереди, статистика по видам и статусам, шоссе и коммуникации посёлка

list_buildings

Корпуса жилого комплекса

list_statuses

Допустимые статусы квартир в ЖК

list_apartments

Объекты с фильтрами по виду, статусу, комнатности, корпусу

get_apartment

Полная карточка: квартира, помещение, машиноместо, кладовая, участок, дом

create_apartment

Создать квартиру, коммерческое помещение, машиноместо, кладовую, участок, дом или таунхаус

update_apartment

Изменить цену, статус и любые поля — с той же проверкой, что в панели

list_house_projects · save_house_project

Каталог проектов домов посёлка: площадь, материал, цены «коробка» … «под ключ»

import_schema · import_preview · import_execute · import_status

Перенос шахматок из ваших файлов: новые ЖК, корпуса и объекты — с предпросмотром «было → стало» и записью только после вашего «да»

files_list · file_read

Файлы хранилища: найти и прочитать таблицу или картинку, чтобы перенести шахматку

bulk_update_status

Массовая смена статуса — до 500 объектов за вызов

bulk_update_price

Массовое изменение цен: фиксированная сумма или процент

get_feed_urls

Постоянные ссылки XML-фидов для площадок

generate_feed

Пересобрать фид любой площадки

feed_list · feed_create · feed_update

Фиды с отбором: все объекты или только нужные — например, на Авито только машиноместа

crm_list_clients · crm_get_client

CRM: клиенты застройщика с фильтрами и карточка — квартиры, сделка, чек-лист, лента, задачи

crm_create_client · crm_update_client

Новый лид (например, с Авито или сайта) и правка статуса, ответственного, полей

crm_link_apartment · crm_set_apartment_stage

Интерес или бронь объекта, затем сделка → куплена или отказ; статус в шахматке меняется сам, у участка — дом по проекту

crm_add_comment · crm_add_task · crm_complete_task

Заметки и звонки в ленту, задачи менеджерам с уведомлениями

agent_list_programs · agent_fix_client · agent_list_fixations · agent_extend_fixation · agent_showing_slots · agent_request_showing · agent_request_booking · agent_list_commissions

Агенту: программы застройщиков, закрепление клиента по телефону, продление, запись на показ и бронь, начисления

partners_list_fixations · partners_decide_fixation · partners_list_showings · partners_decide_showing · partners_decide_booking · partners_list_commissions · partners_update_commission

Застройщику: закрепления агентов и решения по ним, показы, запросы брони, начисления вознаграждения и выплаты

crm_summary · crm_list_statuses · crm_list_sources · crm_list_team

Сводка за неделю/месяц/квартал и справочники CRM

Витрины и виджеты — 13 инструментов с отдельным разрешением

Работают только по API-ключу, у которого включено «Управление витриной и виджетами»; публикация — подопция «и публиковать». Подключению по OAuth каналы недоступны.

channel_schema · channel_list · channel_get · channel_embed_code · channel_stats

Что можно настроить, каналы проекта CRM, канал целиком, код вставки и ссылки, показы и заявки за 30 дней

channel_create · channel_update_design · channel_update_blocks · channel_set_form · channel_set_domains · channel_set_quiz

Создать виджет или витрину (выключенными), оформление, блоки, форма заявки, домены, квиз

channel_publish · channel_unpublish

Опубликовать и снять с публикации — только с подопцией «и публиковать»

quiz_catalog · quiz_list · quiz_get · quiz_create · quiz_update

Квизы и чат-боты: готовые наборы шагов и блоки диалога под вид проекта, закрытия, оформление

quiz_embed_code · quiz_stats · quiz_publish · quiz_unpublish

Ссылка и код вставки квиза, воронка по дням, публикация — с подопцией «и публиковать»

Подключение и аргументы инструментов — в документации MCP.

Публичное API

Шахматка для вашего сайта — без авторизации

У панели и у сайта застройщика разные задачи, поэтому и доступы разные. Витрина, виджет и ваши собственные страницы читают данные по публичному ключу канала dxp_…: он открывает ровно те ЖК, которые вы в канал добавили, и работает только на разрешённых доменах.

Данные отдаются так, чтобы сайт не выкачивал каталог заново: сначала короткая версия шахматки, потом снимок по адресу с этой версией, а при небольших правках — дельта из нескольких квартир. Чтобы не опрашивать вовсе, подпишитесь на вебхуки: события приходят на ваш адрес с подписью HMAC и повторами при сбое.

Подробнее о публичном API

Что доступно по ключу канала dxp_…

  • /version — версия шахматки и счётчики статусов
  • /apartments — снимок по адресу с версией, который кэшируется навсегда
  • /changes?since= — только изменившиеся лоты
  • /leads — заявка с вашей формы прямо в CRM

Что нужно делать по API-ключу dxk_…

  • Вебхуки: подписка в панели или через /webhooks — заявки, брони и продажи, изменения ЖК
  • Управление каналами: /channels и инструменты channel_* — с разрешением «Управление витриной и виджетами»

REST API

Тот же доступ — для CRM и скриптов

REST API открывает шахматку для интеграций: синхронизация с CRM, витрина квартир на сайте застройщика, автоматические скрипты переоценки. База — https://domxml.ru/api/v1, авторизация ключом в заголовке.

  • Уровни доступа: readonly — только чтение, editor — чтение и изменение, full — плюс удаление
  • Ограничение ключа по конкретным ЖК и сроку действия
  • ЖК, квартиры, статусы, корпуса, акции, фиды и журнал изменений — все данные шахматки
Полная документация API

Изменить цену квартиры

curl -X PUT https://domxml.ru/api/v1/complexes/12/apartments/345 \
  -H "Authorization: Bearer dxk_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"price": 5200000}'

Пересобрать фид Домклик

curl -X POST https://domxml.ru/api/v1/complexes/12/feeds/domclick/generate \
  -H "Authorization: Bearer dxk_ВАШ_КЛЮЧ"

Клиенты

Работает с популярными нейросетями и редакторами

Готовые инструкции и конфиги для каждого клиента — в документации MCP.

Claude ChatGPT Claude Code Cursor VS Code (Copilot) Windsurf OpenCode

Безопасность

Доступ под вашим контролем

Секрет — один раз

Ключ показывается только при создании, в базе хранится лишь его хэш. Перехватить сохранённый секрет невозможно.

Границы доступа

Уровень (чтение / редактирование / полный), конкретные ЖК и срок действия задаются для каждого ключа и подключения.

Отзыв в один клик

Все ключи и подключения нейросетей видны в разделе «API и MCP» панели. Отзыв действует мгновенно.

Правки в журнале

Правки ЖК и объектов через API и MCP попадают в журнал ЖК с пометкой способа. Через MCP удалить нельзя, по API удаляет только ключ с полным доступом.

Доступ поддержки — только с вашего разрешения. Если в обращении нужна правка, вы выдаёте поддержке временный ключ: галочкой при обращении или кнопкой «Разрешить» в ответе. Он действует 5 дней, виден в «API и MCP» и отзывается в любой момент, а при закрытии обращения — сам. Ключ работает только с вашими ЖК, ничего не удаляет, CRM и витрины — только если вы их отметили. Его правки помечены в журнале «Поддержка».

Агентство управляет базой через нейросеть

Нейросеть по ключу MCP заведёт объекты вторички из таблицы агента, поправит цены и соберёт фиды. Собственники, договор и комиссия в MCP не передаются — их ведут в панели.

Агентствам и риэлторам

FAQ

Частые вопросы

Что такое MCP и зачем он застройщику?

MCP (Model Context Protocol) — открытый протокол, по которому нейросети подключаются к внешним сервисам. Подключив DomXML, вы просите Claude или ChatGPT поменять цены, статусы квартир или пересобрать фид — обычным сообщением в чате, без ручной работы в таблицах.

Это безопасно — давать нейросети доступ к шахматке?

Вы сами выбираете уровень доступа (только чтение, редактирование или полный), список ЖК и срок действия. Любое подключение отзывается одним кликом. Правки ЖК и объектов попадают в журнал ЖК с пометкой способа: «Нейросеть» — через MCP, «API» — по ключу. Удалять через MCP нельзя; удаление по API — только ключом с полным доступом. Выдать доступы к ЖК нельзя ни через MCP, ни по API — только в панели.

Сколько стоит доступ к API и MCP?

Бесплатно, как и весь DomXML, без тарифов. Есть технические лимиты: до 20 активных ключей, защита от перебора ключей, массовые операции — до 500 объектов за вызов, публичное API для сайтов — 240 запросов в минуту с одного адреса и 1200 в минуту на канал. Число запросов к REST API по ключу не ограничено.

Какие нейросети и редакторы поддерживаются?

Claude (claude.ai), ChatGPT, Claude Code, Cursor, VS Code (Copilot), Windsurf, OpenCode — и любой другой клиент с поддержкой MCP. Готовые конфиги для каждого клиента есть в документации.

Чем REST API отличается от MCP?

REST API — для интеграций и скриптов: CRM, сайт застройщика, автоматизация. MCP — для нейросетей: тот же доступ, но в виде инструментов, которые модель вызывает сама. Ключи и подключения создаются в одном разделе панели «API и MCP».

Подключите нейросеть к шахматке

Создайте аккаунт, вставьте адрес MCP в свой клиент — и управляйте ЖК из чата. Бесплатно.

Начать бесплатно

Смотрите также

Документация MCP Документация API Шахматка онлайн CRM для застройщика