tilda-mcp-cdp

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

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

Зачем

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

Related MCP server: Respira for WordPress

Требования

• 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

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

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

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

• 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