# ⚡ Tilda MCP Server

Отказоустойчивый сервер по протоколу **Model Context Protocol (MCP)** для автономной генерации, стилизации и точечного редактирования коммерческих лендингов на платформе **Tilda**.

Движок спроектирован так, чтобы ИИ-агенты могли собирать законченные конверсионные страницы без ручной верстки, экономя токены и время сборки.

---

## ✨ Ключевые возможности

### 🚀 Архитектура One-Shot Orchestrator
* **`tilda_fast_generate_landing`**: Сквозная сборка лендинга из 10 секций (Header, Hero, Features, Metrics, Pricing, Testimonials, FAQ, Form, Footer, CSS) за один вызов инструмента (~10-12 сек).
* **Минимум токенов**: Из публичного MCP-реестра исключены низкоуровневые атомарные вызовы. В контекст LLM не передаются тяжелые логи и дампы HTML.
* **Быстрый батчинг**: Параллельное обновление независимых блоков пакетами (`Promise.all`) без риска блокировки сессии Tilda.

### 🎨 Smart Defaults & Стилизация
* **Готовые пресеты**: Автоматическая настройка тем (`dark`, `minimal`, `warm`) без раздувания схем.
* **Hero Overlays**: Глубокие контрастные оверлеи (75%/85%) для гарантированной читаемости типографики поверх любых фонов.
* **Локализация форм**: Автоматическая русификация полей, плейсхолдеров и маска номера РФ (`+7`).
* **Auto-CSS Glassmorphism (`T123`)**: Изолированная инъекция кастомных стилей с эффектом матового стекла (`backdrop-filter: blur(16px)`), аккуратными границами и неоновыми акцентами для тарифов «Хит продаж».

### 🛡️ Отказоустойчивость уровня Production
* **Session Healthcheck (`checkAuth`)**: Проверка валидности куки до создания страницы. Мгновенное прерывание с понятной ошибкой при протухшей сессии (`[AUTH_EXPIRED]`).
* **Exponential Retry & Backoff**: Автоматический повтор запросов (до 3 попыток с паузами 1000 мс и 2500 мс) при ошибках `429 (Rate Limit)`, `502`, `503`, `504` и сетевых сбоях.
* **Транзакционный откат (Rollback)**: Аварийное удаление созданного черновика (`movetobinpage`), если сборка оборвалась на середине.
* **JSON Sanitizer**: Безопасная обработка спецсимволов (« », ", &, тире) перед отправкой в параметры блоков Tilda.

### ⚡ Точечное редактирование (`tilda_update_page_section`)
* Мгновенное обновление конкретной секции (например, изменение цен или отзывов) за **~2.9 секунды** с автопоиском блока по якорю и автоматической перепубликацией.

---

## 🧭 Навигация и якоря

Движок поддерживает сквозную бесшовную навигацию по 6 ключевым разделам:
* `#features` - Преимущества / Направления
* `#metrics` - Цифры и факты
* `#pricing` - Тарифная сетка
* `#reviews` - Отзывы клиентов
* `#faq` - Частые вопросы
* `#form` - Форма захвата лидов

---

## 🛠️ Установка и сборка

```bash
git clone [https://github.com/Gabriel329-bot/tilda-mcp.git](https://github.com/Gabriel329-bot/tilda-mcp.git)
cd tilda-mcp
npm install
npm run build
```

---

## ⚙️ Конфигурация окружения

Создайте файл `.env` в корневой директории проекта:

```env
TILDA_COOKIES="ssaid=ВАШ_SSAID; tildauid=ВАШ_TILDAUID"
TILDA_PROJECT_ID="40607103"
```

> **Важно:** Никогда не коммитьте файл `.env` в репозиторий. Убедитесь, что он добавлен в `.gitignore`.

---

## 🧪 Тестирование

Запуск тестов устойчивости и ретраев через Vitest:

```bash
npm test
```

---

## 📄 Лицензия

Проект распространяется под лицензией **BSL 1.1 (Business Source License)**:
* ✅ **Разрешено:** изучение исходного кода, форки для личных некоммерческих тестов, локальная разработка и аудит.
* ❌ **Запрещено:** коммерческое использование в продакшене, применение агентствами для сдачи клиентских сайтов, развёртывание платных сервисов или API на базе данного кода без письменного согласия правообладателя.
* По вопросам коммерческого лицензирования свяжитесь через профиль автора.