Modo headless

Usa el modo headless cuando tus lectores visiten un sitio distinto al de esta instalación de WordPress. Configuraciones habituales:

• Este WordPress se ejecuta en cms.example.com y tu blog se sirve desde example.com mediante un frontend Next.js, Astro u otro generador estático.
• Este WordPress es el backend editorial de una SPA o app móvil, y «el sitio público» es un sitio de marketing en un dominio aparte.

Sin el modo headless, Structura asume que esta instalación de WordPress es el sitio público. Esa suposición es cierta para la gran mayoría de instalaciones, pero falla en los casos anteriores: las sugerencias de IA se basan en la portada de WP (vacía en headless), los enlaces internos que Structura añade a los nuevos posts apuntan a URLs de cms.example.com que nadie visita, y los compartidos por canal (LinkedIn, IndexNow, Slack) publican URLs incorrectas.

Antes de empezar

Necesitas:

• La URL completa de tu sitio web público (por ejemplo, https://example.com).
• Acceso de administrador a wp-admin.

Si publicas desde este WordPress hacia tu frontend mediante una canalización de build CMS (Vercel ISR, Astro Content Collections, etc.), asegúrate de que esa integración ya esté funcionando antes de activar el modo headless — los ajustes de Structura solo describen lo que ya está desplegado.

Pasos

1. En wp-admin, ve a Ajustes → General → Sitio web público.
2. Activa Mi sitio web público está en otro lugar (modo headless).
3. Pulsa Detectar y configurar automáticamente. Structura:
   • Propondrá una URL pública eliminando un prefijo cms. del host de esta instalación (así cms.xerx.io → https://xerx.io).
   • Analizará esa URL con Jina y propondrá una descripción y unas páginas clave.
   • Abrirá un diálogo de confirmación con las propuestas.
4. Revisa las propuestas. Aplicar propuestas las escribe en el formulario — todavía puedes editar cada campo antes de guardar.
5. Opcional: ajusta:
   • Descripción — un párrafo breve usado como respaldo cuando la fundamentación de IA no puede acceder a tu portada.
   • Páginas clave — las páginas «sobre», «precios», «servicios», etc., a las que Structura debería considerar enlazar desde nuevos posts. La lista se autodetecta desde tu navegación; quita o renombra filas según necesites.
   • Patrón de URL de las entradas — cómo Structura debe componer las URLs de los posts publicados desde este WordPress. El valor por defecto Sustitución de prefijo ({publicUrl}/{lang}/blog/{slug}) coincide con el diseño recomendado por Structura; elige Plantilla personalizada… si tu frontend usa otro esquema (por ejemplo, /news/{year}/{slug}).
   • Idioma predeterminado de las URLs — se usa cuando {lang} aparece en el patrón de URL. Por defecto es el idioma de tu sitio WP.
6. Pulsa Guardar.

Qué sucede a continuación

Una vez activo el modo headless:

• La fundamentación de IA analiza tu sitio web público, no WordPress. Las sugerencias reflejan la marca y el contenido que los lectores realmente ven.
• Los enlaces internos que Structura añade a los nuevos posts apuntan a las URLs públicas reescritas (por ejemplo, https://example.com/es/blog/<slug>).
• Los canales que comparten URLs de posts (LinkedIn, Slack, webhooks) publican la URL pública.
• IndexNow también apunta a la URL pública — consulta la página del canal IndexNow para el paso de subida del archivo de clave que es específico de las instalaciones headless.

La próxima vez que WordPress guarde un post, la URL del post que Structura emite en structura/post/inserted será la reescrita. Los posts existentes conservan la URL que tuvieran en su meta _structura_* — no es necesario republicar a menos que quieras refrescar el estado derivado.

Problemas habituales

El botón «Detectar y configurar automáticamente» se queda deshabilitado. Este botón solo se dispara cuando hay algo que analizar — confirma que el campo URL pública tiene un valor o que el host de esta instalación empieza por cms. (el disparador de autoderivación). De lo contrario, escribe la URL pública manualmente primero.

La configuración rápida indica «scrape failed». La causa más probable es que el sitio público esté protegido (contraseña de Vercel, lista de IPs permitidas, autenticación básica). Añade la URL manualmente, rellena la descripción y las páginas clave tú mismo, y guarda.

Las vistas previas de canal siguen mostrando URLs cms.*. Lanza una nueva publicación — Structura solo calcula la URL reescrita en el momento de la inserción, por lo que las tarjetas de vista previa cacheadas en posts existentes no se actualizarán hasta que el post se vuelva a guardar o el canal envíe un nuevo evento.

El archivo de clave de IndexNow no se verifica. Consulta la sección de resolución de problemas de IndexNow. La causa más habitual es que el archivo no esté accesible en la URL exacta mostrada — normalmente un despliegue aún en curso, o el archivo en un subdirectorio en lugar de la raíz pública del frontend.

Páginas relacionadas

• Canal IndexNow — flujo de subida y verificación del archivo de clave para instalaciones headless.
• Recorrido por la página de ajustes — visión general del resto de la página Ajustes generales.
• Cómo funcionan los canales — qué emite Structura en cada publicación y qué canales lo consumen.