<!-- Universal Web · versión Markdown para agentes de IA · HTML: https://universal-web.healthpoint-suite.es/como-funciona -->

# Cómo funciona Universal Web

Un back fijo, un contrato JSON y temas intercambiables. Así de simple.

## La arquitectura en una pantalla

Universal Web separa **qué dices** de **cómo se ve**:

- **Back fijo**: guarda páginas, entradas, imágenes, usuarios y mensajes en SQLite. No cambia nunca.
- **Contrato JSON**: cada página es una lista de bloques (`hero`, `text`, `features`, `faq`...) con campos conocidos.
- **Temas**: plantillas PHP que pintan esos bloques. Puedes usar el que quieras o hacer tu propio front.

Además es **multi-web**: el dominio de cada petición decide qué web se sirve. Una sola instalación puede alojar tu web principal, la de un cliente y un blog personal, cada una con su tema y su contenido.

## En tres pasos

- **Instala**: Sube el zip a tu hosting y abre /install en el navegador. Tardarás menos de un minuto.
- **Crea un token MCP**: En el panel, elige tu web, los permisos y copia el token. Solo se muestra una vez.
- **Pídeselo a Claude**: Escribe: «crea una entrada sobre X y optimiza el SEO». Claude hace el resto con las herramientas MCP.

## Así responde /api/pages/index.json

```json
{
  "page": {
    "slug": "index",
    "title": "Tu web, gestionada por IA",
    "url": "https://tu-dominio/",
    "seo": { "title": "...", "description": "..." },
    "blocks": [
      { "type": "hero", "data": { "title": "...", "subtitle": "..." } },
      { "type": "features", "data": { "items": [ { "icon": "🌐", "title": "..." } ] } }
    ]
  }
}
```

## Las herramientas MCP principales

```text
site_get          Datos y ajustes de la web
site_update       Nombre, menú, cabecera, contacto, SEO y tema
block_types       Tipos de bloque y sus campos
page_list         Lista las páginas
page_get          Lee una página con sus bloques
page_save         Crea o edita una página
page_delete       Elimina una página
post_list         Lista las entradas del blog
post_get          Lee una entrada
post_save         Crea o edita una entrada
post_delete       Elimina una entrada
media_list        Lista imágenes, vídeos y audios
media_upload      Sube un archivo por URL o base64
messages_list     Lee los mensajes de contacto
message_mark_read Marca un mensaje como leído
code_get          Lee el CSS/JS/<head> personalizado
code_update       Cambia el diseño con CSS/JS (con versiones)
code_history      Versiones anteriores del diseño
code_restore      Deshace un cambio de diseño
backup_create     Crea una copia de seguridad
backup_list       Lista las copias
seo_audit         Audita el SEO y da una puntuación
sites_list        Lista las webs (token global)
site_create       Crea una web nueva (token global)
```

## Prueba un front alternativo

¿Quieres ver el contrato JSON en acción? Abre [/examples/headless.html](/examples/headless.html): un front alternativo hecho solo con HTML y JavaScript que lee la API de esta misma web.

También hay una **segunda web de demostración**, *Café Aurora*, en [cafe.universal-web.healthpoint-suite.es](http://cafe.universal-web.healthpoint-suite.es): mismo back, otro dominio y otro tema.
