Tilda Cdp

MCP-сервер для Tilda с поддержкой массового редактирования. 16 инструментов: 5 на чтение через официальный API + 11 на запись через залогиненный Chrome по CDP (Яндекс.Метрика, код-блоки T123, ссылки Zero Block, полноценный редактор элементов Zero Block, публикация, проверка живого кода).

License: MIT

Официальный API Tilda умеет только читать. Этот сервер добавляет слой действий через CDP (управление залогиненным Chrome), чтобы массово править сайты прямо из MCP.

Зачем

Официальный Tilda API (api.tildacdn.info) — только чтение. Любые изменения сайта (счётчик Метрики, сторонние скрипты в блоках, ссылки кнопок, публикация) делаются только в интерфейсе. Этот сервер автоматизирует их, управляя твоим залогиненным Chrome по протоколу отладки (CDP) — так можно массово править десятки одинаковых лендингов одной командой.

Требования

• Node.js ≥ 18
• Для чтения: TILDA_PUBLIC_KEY + TILDA_SECRET_KEY (настройки аккаунта Tilda)
• Для действий: запущенный Chrome с портом отладки и входом в Tilda (см. ниже)

Установка

git clone https://github.com/skiddgoddamn/tilda-mcp-cdp.git
cd tilda-mcp-cdp
npm install
npm run build

Подключение к Claude Code / Desktop / Cursor

{
  "mcpServers": {
    "tilda": {
      "command": "node",
      "args": ["/абсолютный/путь/tilda-mcp-cdp/dist/index.js"],
      "env": {
        "TILDA_PUBLIC_KEY": "your-public-key",
        "TILDA_SECRET_KEY": "your-secret-key",
        "TILDA_CDP_URL": "http://localhost:9222"
      }
    }
  }
}

Запуск debug-Chrome (для инструментов записи)

Chrome 136+ блокирует порт отладки на профиле по умолчанию (защита cookies), поэтому запускаем на отдельном профиле и один раз логинимся в Tilda:

chrome.exe --remote-debugging-port=9222 --user-data-dir="C:\chrome-debug-tilda" --no-first-run https://tilda.cc/projects/

Проверить, что всё подключилось: вызови инструмент chrome_status — он покажет connected, loggedIn и аккаунт. Адрес CDP меняется переменной TILDA_CDP_URL.

Streamable HTTP

TILDA_PUBLIC_KEY=xxx TILDA_SECRET_KEY=yyy node dist/index.js --http --port 3001
# Endpoint: http://localhost:3001/mcp   Health: http://localhost:3001/health

Инструменты (16)

Чтение — официальный API

Инструмент	Описание
get_projects	Список проектов
get_project_info	Подробная информация о проекте (домен, настройки, CSS/JS)
get_pages	Список страниц проекта
get_page	Полная информация о странице (HTML, CSS, JS)
get_page_export	Экспорт страницы для самостоятельного хостинга

Действия — через Chrome по CDP

Инструмент	Аргументы	Описание
chrome_status	—	Проверка CDP-подключения и сессии Tilda
set_metrika	projectid, metrikaId	ID Яндекс.Метрики в настройках проекта
replace_page_code	pageid, find, replace, publish?	Замена (regexp) в HTML-код-блоках T123 — напр. трекеры
replace_zero_links	pageid, find, replace, publish?	Замена ссылок (regexp) в элементах Zero Block — напр. кнопки
publish_page	pageid	Опубликовать страницу
verify_live	urls, contains?, notContains?	Проверка живого HTML на наличие/отсутствие подстрок

Редактор Zero Block — через CDP

Полноценное редактирование элементов Zero Block по модели артборда (детерминированно, без кликов по холсту). Сначала всегда zero_get_elements, чтобы увидеть реальные id и имена полей, потом правишь.

Инструмент	Аргументы	Описание
zero_get_elements	pageid, recId?/match?, raw?	Список элементов блока: тип, текст, ссылки, геометрия, все поля (raw — полный объект)
zero_update_element	pageid, recId?/match?, id?/index?/textContains?, patch, publish?	Deep-merge JSON-патча в элемент(ы): текст, цвет, шрифт, размер, позиция, ссылка (null удаляет поле)
zero_add_element	pageid, recId?/match?, cloneId?/cloneIndex?/cloneTextContains?, element?, patch?, newId?, publish?	Добавить элемент: клон существующего (schema-safe) + патч, либо произвольный JSON-объект
zero_delete_element	pageid, recId?/match?, id?/index?/textContains?, publish?	Удалить выбранный элемент(ы)
zero_set_text	pageid, recId?/match?, find, replace, publish?	Regexp-замена текста/строк по всей модели блока

• find — это регулярное выражение (флаг g применяется автоматически).
• Действия записи (replace_page_code, replace_zero_links, zero_*) по умолчанию публикуют страницу (publish: true).
• Изменения видны на сайте только после публикации.
• Выбор Zero Block: recId (если знаешь) или match — regexp по содержимому блока.
• Выбор элемента: id (ключ из zero_get_elements), index (0-based) или textContains. Критерии объединяются по И.

Как это работает под капотом

• Метрика — поле #yandexmetrikaid в настройках проекта (вкладка «Аналитика»).
• Код-блоки T123 — содержимое редактируется в ACE-редакторе (window.ace), сохранение «Сохранить и закрыть».
• Ссылки Zero Block — берётся модель блока (ab__getDBSaveData()), ссылки заменяются в cleanElementsData и сохраняются POST-запросом /zero/submit/ (детерминированно, без кликов по холсту).
• Редактор Zero Block (zero_*) — тот же путь, обобщённый: модель cleanElementsData читается из артборда наружу, правится в Node (deep-merge патча / клонирование / удаление / regexp) и сохраняется обратно /zero/submit/. Схема полей не хардкодится — zero_get_elements показывает реальные имена, новые элементы создаются клонированием существующих (всегда валидны).
• Публикация — кнопка #page_menu_publishlink.
• Проверка — живой HTML грузится через сам браузер с обходом кэша (tilda.ws отдаёт 403 на прямые запросы).

Примеры запросов

# Чтение
Покажи мои проекты в Tilda
Список страниц проекта 12345
Экспортируй страницу 67890

# Действия (нужен запущенный debug-Chrome)
Проверь статус Chrome
Поставь Метрику 109756541 в проект 23943806, потом опубликуй её страницы
На странице 131579756 замени в коде counterID=108377870 на counterID=109756541
На странице 131579756 замени ссылку https://t\.me/\+\w+ на https://t.me/+NEW и опубликуй
Проверь, что на dubaiphonemart.com есть +NEW и нет +OLD

# Редактор Zero Block
Покажи элементы Zero Block на странице 131579756 (match: "Оставить заявку")
В блоке с текстом "45%" поменяй текст элемента с "45" на "от 45% годовых*"
Добавь вторую кнопку: склонируй элемент с textContains "Оставить заявку", патч text="Узнать подробнее", top=650
Удали элемент с index 4 в Zero Block страницы 131579756

Разработка

npm run dev     # запуск из исходников (tsx)
npm run build   # сборка в dist/
npm test        # тесты (vitest)

Лицензия

MIT