io.github.theYahia/tilda-mcp

MCP server for Tilda API — projects, pages. 3 tools.
Open source Open in the app JSON README (API)
About

MCP server for Tilda API — projects, pages. 3 tools.
Details

Kind: MCP servers
Topic: No topic detected
Publisher: theyahia
Origin: official
Category: ferramentas
Transport: local
Version: 1.0.0
Stars: 13
Forks: 2
Open pull requests: 1
Last push: 2026-09-02T19:02:47Z
Repository state: ativo
Language: TypeScript
License: MIT
Added: 2026-08-29 04:01:32
Updated: 2026-08-29 04:01:32
Origin id: io.github.theYahia/tilda-mcp
README

# MCP-сервер для Tilda API — 7 инструментов для ИИ-агента: проекты, страницы, экспорт

Если вы искали, как подключить сайт на Tilda к Claude или другому ИИ-агенту, — этот сервер отдаёт агенту ваши проекты и страницы через Tilda API: список страниц с датами публикации, полный HTML и CSS любой страницы, экспорт проекта целиком. Спрашиваете «что за страницы в проекте и когда их публиковали» — агент отвечает таблицей, а не ссылкой на документацию. Нужны только публичный и секретный ключи из настроек Tilda.

[![npm](https://img.shields.io/npm/v/@theyahia/tilda-mcp)](https://www.npmjs.com/package/@theyahia/tilda-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![Демонстрация: вопрос «что за страницы в проекте и когда их публиковали» — агент вызывает get_pages и отвечает таблицей страниц с датами](https://raw.githubusercontent.com/theYahia/WWmcp/main/servers/tilda/assets/demo.svg)

Часть серии [WWmcp](https://github.com/theYahia/WWmcp) (46 серверов) by [@theYahia](https://github.com/theYahia).

## Установка

### Claude Desktop

```json
{
  "mcpServers": {
    "tilda": {
      "command": "npx",
      "args": ["-y", "@theyahia/tilda-mcp"],
      "env": { "TILDA_PUBLIC_KEY": "your-public-key", "TILDA_SECRET_KEY": "your-secret-key" }
    }
  }
}
```

### Claude Code

```bash
claude mcp add tilda -e TILDA_PUBLIC_KEY=your-public-key -e TILDA_SECRET_KEY=your-secret-key -- npx -y @theyahia/tilda-mcp
```

### VS Code / Cursor

```json
{ "servers": { "tilda": { "command": "npx", "args": ["-y", "@theyahia/tilda-mcp"], "env": { "TILDA_PUBLIC_KEY": "your-public-key", "TILDA_SECRET_KEY": "your-secret-key" } } } }
```

### Streamable HTTP

```bash
TILDA_PUBLIC_KEY=xxx TILDA_SECRET_KEY=yyy npx @theyahia/tilda-mcp --http --port 3001
# Endpoint: http://localhost:3001/mcp  (stateless, CORS включён)
# Health:   http://localhost:3001/health  → {"status":"ok","tools":7}
```

HTTP-режим работает в **stateless**-режиме: на каждый POST создаётся свежий сервер+транспорт (подходит для чистой API-обёртки, поддерживает несколько клиентов без коллизий сессий). Принимает `POST`/`OPTIONS` на `/mcp`; прочие методы → `405`.

### Smithery

```bash
npx @smithery/cli install @theyahia/tilda-mcp
```

> Требуется `TILDA_PUBLIC_KEY` и `TILDA_SECRET_KEY`. Получите в [настройках аккаунта Tilda](https://tilda.cc/identity/apikeys/).

## Инструменты (7)

Полное покрытие всех 7 методов Tilda API.

| Инструмент | Метод API | Описание |
|------------|-----------|----------|
| `get_projects` | `getprojectslist` | Список проектов |
| `get_project_info` | `getprojectinfo` | Информация о проекте (домен, настройки экспорта). Опц. `webconfig=htaccess\|nginx` → пример конфига веб-сервера |
| `get_pages` | `getpageslist` | Список страниц проекта |
| `get_page` | `getpagefull` | Полная страница (HTML c `<head>`, CSS, JS; ссылки на Tilda CDN) |
| `get_page_body` | `getpage` | Только тело страницы (HTML без `<head>`; ссылки на CDN) — для быстрого чтения/preview |
| `get_page_export` | `getpagefullexport` | Экспорт полной страницы с локализованными ассетами `{from,to}` — для самостоятельного хостинга |
| `get_page_export_body` | `getpageexport` | Экспорт тела страницы с локализованными ассетами — для вставки в свой шаблон/CMS |

**Экономия контекста:** инструменты страниц (`get_page*`) принимают опц. `metadata_only: true` — вернуть только метаданные без `html`/`css`/`js` (полезно для больших страниц).

**Экспорт всего проекта:** отдельного метода нет — получите `get_pages`, затем по каждому `id` вызовите `get_page_export` (или `get_page_export_body`).

> **Лимит Tilda API:** 150 запросов в час. Клиент делает ретраи с экспоненциальной задержкой и учитывает заголовок `Retry-After`.

> **Безопасность:** Tilda API принимает ключи только как query-параметры (`publickey`/`secretkey`) — это особенность самого API. Сервер не логирует URL с ключами; держите ключи в env, не передавайте их в незашифрованные логи/прокси.

## Скиллы

| Скилл | Триггер |
|-------|---------|
| `/skill-get-pages` | Покажи все страницы сайта |
| `/skill-export-page` | Экспортируй страницу |

## Примеры

```
Покажи мои проекты в Tilda
Информация о проекте 12345 с конфигом nginx
Список страниц проекта 12345
Покажи содержимое страницы 67890
Покажи только метаданные страницы 67890
Экспортируй страницу 67890 для своего хостинга
Экспортируй тело страницы 67890 для вставки в шаблон
```

## Лицензия

MIT

---

Часть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)
io.github.theYahia/tilda-mcp

About

Details

README

More
