Migración a AliothPress con un agente de IA

Esta guía recorre la migración de un sitio desde otro CMS a AliothPress con un agente de IA y las herramientas WebMCP integradas: sin archivos de exportación, sin plugins de importación y sin depender de lo que el constructor de páginas del sitio viejo esté dispuesto a entregarte. El agente lee el sitio antiguo en una pestaña del navegador, reescribe cada contenido en limpio y lo deja todo en AliothPress como borradores que tú revisas y publicas. El marcado del sitio viejo, sus estilos en línea, sus shortcodes rotos y sus errores acumulados se quedan atrás, porque no se copia ni una sola línea de su código.

Cómo funciona

Un agente compatible con WebMCP en tu navegador ve dos cosas a la vez: el sitio antiguo (como cualquier visitante) y tu panel de administración de AliothPress (como tú, dentro de tu sesión iniciada). En lugar de analizar un volcado de base de datos, el agente lee cada página antigua como lo haría un editor cuidadoso, la reescribe como HTML semántico limpio y la guarda por las mismas rutas del panel que usa un humano, con tu confirmación en cada escritura.

Tres propiedades hacen que esto sea seguro para un sitio en producción:

• Todo llega como borrador. Los agentes no pueden publicar jamás. Las peticiones de publicar se degradan a borrador en el servidor, con independencia de lo que el agente o sus herramientas afirmen. Nada aparece en el sitio público hasta que tú mismo lo publicas.
• Cada escritura la apruebas tú. Las acciones individuales muestran un diálogo de confirmación, y las acciones en lote muestran un solo diálogo para todo el conjunto (detalles más abajo).
• Cada acción queda registrada. Los cambios hechos por el agente aparecen en el registro de auditoría como cualquier otra acción del panel, atribuidos a tu usuario.

Antes de empezar

1. Activa la superficie de administración. Abre la página del Asistente de IA en el panel y activa el Panel de administración bajo el acceso de agentes de IA (WebMCP). Puedes apagarlo en cuanto termine la migración. El acceso se revoca al instante.
2. Asegúrate de que el agente de tu navegador ve las herramientas. O tu navegador soporta WebMCP de forma nativa (pega tu token de origin trial en el campo de esa misma página del Asistente de IA), o activas allí la casilla del polyfill de compatibilidad.
3. Inicia sesión en el panel de administración en el perfil del navegador que usa el agente. El agente trabaja dentro de tu sesión y hereda exactamente tus permisos, ni un gramo más.
4. Ten el sitio antiguo accesible en el mismo navegador: en público, o con la sesión iniciada si el contenido está detrás de un login.
5. Opcional pero recomendado: configura un proveedor de IA en la página del Asistente de IA. El agente obtiene entonces también herramientas de generación, traducción y SEO que funcionan con tu propia clave de API.

El modelo de aprobación durante una migración

Una migración implica decenas o cientos de escrituras, así que las aprobaciones están pensadas para escalar en lugar de multiplicarse:

• Aprobación por lotes. Cuando el agente usa create_posts_batch o create_pages_batch, recibes un diálogo que lista todos los títulos con casillas: selecciona todo o aprueba un subconjunto elegido a mano. Los elementos omitidos se devuelven al agente, que sabe exactamente qué pasó.
• Piloto automático. Cualquier diálogo de aprobación ofrece la aprobación automática con límite de tiempo: marca la casilla, elige 15 o 60 minutos, y las siguientes acciones del agente en esa pestaña del navegador se aprueban solas. Una insignia visible muestra la cuenta atrás y se revoca con un clic. Solo un humano puede activar el piloto automático (no existe como herramienta del agente), e incluso con él, publicar sigue siendo imposible.

Paso a paso

1. Inventario del sitio antiguo

Pide al agente que recorra el sitio antiguo y produzca una lista de las páginas y entradas que merecen la migración: URL, título, idioma y si la página incluye imágenes o un diseño compuesto. Este es también el momento de decidir qué no se lleva. Una migración sin archivo de exportación es una migración sin desván: las páginas obsoletas simplemente se quedan atrás.

2. Recrear entradas y páginas como borradores

El agente lee cada página antigua y la recrea con create_posts_batch o create_pages_batch. Cada elemento del lote admite título, contenido, extracto, idioma, slug, etiquetas, categoría, campos SEO y campos de imagen. Hay dos instrucciones que vale la pena darle al agente de forma explícita:

• Reescribir, no copiar. El contenido debe ser HTML semántico limpio (encabezados, párrafos, listas, citas), escrito a partir del significado de la página antigua, no un pegado de su marcado. Ese es justamente el sentido de migrar así.
• Pasar el slug antiguo. Cada elemento acepta un slug, así que URLs como /about-us siguen funcionando tras el cambio. Los slugs se sanean y desduplican automáticamente. check_slug comprueba la disponibilidad de antemano.

En sitios multilingües, migra primero un idioma y crea después los demás con translation_of apuntando al id del elemento de origen (de list_content). El servidor los enlaza en un translation group, así que hreflang y el selector de idioma funcionan exactamente igual que si hubieras traducido a mano.

3. Llevarse las imágenes

El agente sube cada imagen con upload_image (el archivo viaja como base64, con nombre y texto alternativo obligatorio, la misma regla de accesibilidad que aplica el formulario de subida humano). Cada subida pasa por la canalización estándar de medios: redimensionado, eliminación de EXIF, variantes WebP y AVIF, saneado de SVG. Las imágenes migradas salen más limpias que las originales. Las ya subidas se encuentran con list_media, así que nada se sube dos veces.

4. Adjuntar las imágenes destacada y sociales

Con las URLs de las imágenes en la mano, attach_image define la imagen destacada, la de Open Graph, la de la tarjeta de Twitter o las tres en un solo paso: solo cambian los campos de imagen, todo lo demás de la entrada o la página se conserva. Para ajustes más finos (un extracto aquí, una meta description allá), update_post y update_page cambian exactamente los campos que nombras y dejan el resto intacto.

5. Reconstruir las páginas diseñadas en el Page Builder

Las páginas de aterrizaje y otros diseños compuestos del constructor del sitio viejo no necesitan copiarse, y tampoco deberían. El agente lee describe_builder_blocks, una referencia legible por máquinas de todos los tipos de bloque que trae AliothPress (secciones, columnas, presentaciones, galerías, acordeones, tablas, tickers, formularios y el resto), y luego recrea el diseño de forma nativa con create_builder_page. Los diseños existentes se leen con get_page_blocks y se actualizan con set_page_blocks. Una regla para recordar: en una página del builder, el diseño se cambia con las herramientas de bloques, no con el campo content. Las herramientas le dirán lo mismo al agente si lo intenta.

6. Conectar los menús

Cuando las páginas ya existen, build_menu define los menús del encabezado y del pie a partir de una lista de ids de páginas y entradas, anidación incluida. Como toda escritura, primero te pregunta.

7. Revisar y publicar

En este punto, todo el sitio migrado está en tu panel como borradores. Léelos, corrige lo que haga falta (tú o a través del agente) y publica desde el panel de administración, el único paso que es solo tuyo. Al terminar, puedes volver a apagar la superficie de administración en la página del Asistente de IA.

Conservar tus URLs

• Mismo dominio: pasa las rutas antiguas como slugs durante la creación (paso 2) y las URLs simplemente siguen funcionando.
• ¿Cambiaste de idea sobre un slug más tarde? Al editar el slug de una entrada o página existente, AliothPress crea automáticamente una redirección desde el slug antiguo.
• Dominio nuevo: las redirecciones desde el dominio antiguo son tarea de la configuración del servidor antiguo (o de tu panel de DNS u hosting), no del CMS.

Un prompt para tu agente

Migra el contenido de https://sitio-antiguo.example a este panel de AliothPress.

1. Lista todas las páginas y entradas del sitio antiguo. Enséñame la lista
   antes de hacer nada.
2. Para cada elemento aprobado: reescribe el contenido como HTML semántico
   limpio desde cero. No copies el marcado antiguo. Conserva el slug
   original. Traslada título, extracto, etiquetas, categoría y meta
   description donde existan.
3. Créalo todo con create_posts_batch / create_pages_batch (borradores).
4. Sube las imágenes de cada elemento con upload_image (escribe textos
   alternativos descriptivos) y adjunta las imágenes destacada, OG y de
   Twitter con attach_image (slot: all).
5. Reconstruye las páginas diseñadas con las herramientas del Page Builder.
   Consulta primero describe_builder_blocks.
6. Recrea los menús del encabezado y del pie con build_menu.
7. Informa de todo lo que saltes o no puedas mapear, para que lo haga yo
   a mano.

Las salvaguardas, en resumen

• Los agentes crean y editan solo borradores: publicar está bloqueado en la capa de herramientas y en el servidor
• Cada escritura la confirmas tú: una a una, por lotes o bajo un piloto automático con límite de tiempo que solo tú puedes activar y revocar con un clic
• Los envíos de formularios (datos personales de los visitantes) están totalmente excluidos de los endpoints de agente
• Todo lo que hace el agente queda en el registro de auditoría
• Un interruptor en la página del Asistente de IA revoca todo el acceso de agentes al instante