Añade un blog a tu sitio creado con IA
Para sitios con una interfaz propia, incluidos los creados con IA.
Conserva tu web y añade un blog con su diseño. Structura investiga y escribe; tu web muestra los artículos en tu dominio. La entrega de artículos envía el artículo completo cuando lo publicas.
Antes de empezar
Necesitas una web publicada, un backend que acepte solicitudes HTTPS y una base de datos. Tu creador puede generarlos, pero debes probar el resultado. Es una integración personalizada, no un conector oficial de Lovable, Bolt, v0 o Replit.
La entrega de artículos está disponible para sitios Headless en el portal de clientes. Los sitios WordPress no la ofrecen.
Los sitios con un framework tampoco la usan. Si eliges Next.js, Astro, Nuxt, SvelteKit u Otro framework o app como Plataforma de tu sitio, tu sitio obtiene los artículos publicados de la Content API, y el asistente de configuración te muestra las solicitudes.
La entrega requiere un plan base de pago de Structura, sin el complemento Channels. Para una opción headless gratuita, usa la Content API pública. La IA y el alojamiento pueden tener costes adicionales.
Pasos
La ruta más rápida empieza con la dirección de tu sitio: Conectar un sitio abre el asistente de configuración del sitio, y su último paso, Conectar, te guía por el receptor.
-
En el portal de clientes, selecciona Conectar un sitio. Introduce tu URL pública del sitio y selecciona Continuar. Structura lee tu sitio, lo crea y abre Datos del sitio.
-
En Plataforma, comprueba que tu creador está seleccionado, o elige Mi propio backend para un sitio hecho por ti. Si Structura reconoció tu creador, el campo dice Detectada en tu sitio. Un dominio propio suele ocultar el creador; entonces el campo dice No detectada y lo eliges tú en la lista (o con Cambiar de plataforma si se equivocó). Structura reconoce un sitio de v0 por la marca que v0 añade a sus páginas, también con un dominio propio. Sin esa marca, sugiere Next.js, que obtiene los artículos de la Content API; elige v0 si creaste tu sitio con v0.
-
Recorre el asistente. Su último paso antes del final es Conectar. Copia el prompt en tu creador; es el mismo prompt que el de la pestaña de tu creador más abajo, y remite a tu creador al contrato de entrega. Lovable añade una ruta de recepción dentro de tu sitio, normalmente
/api/public/structura-articles; Bolt crea una Supabase Edge Function llamadastructura-articles; v0 y Replit añaden una ruta en/api/structura. En un sitio hecho a medida, sigue directamente el contrato. Después pega la URL del receptor que te da tu creador y selecciona Continuar. -
En Verificar, guarda la Clave de firma en el almacén de secretos del backend como
STRUCTURA_SIGNING_SECRET. Solo se muestra una vez. Nunca la pegues en el chat, código público ni variables del navegador. Puede que tu creador te ofrezca un formulario de secretos en su chat; úsalo en lugar de pegar la clave como texto plano. La conexión se guarda en cuanto aparece la clave, así que puedes ir a tu creador y volver cuando quieras para enviar la prueba: el paso Conectar muestra entonces la conexión guardada como Sin probar, con Enviar entrada de prueba. -
Elige Enviar una entrada de prueba ahora para comprobar el receptor al momento. Tu sitio la guarda como «Structura test article»; bórrala después. Una prueba superada marca la conexión como Conectado al instante. O elige Probar con mi primera entrada real y selecciona Probar más tarde: no se envía nada y tu primera entrada publicada es la prueba. ¿Aún no puedes pegar una URL del receptor? Selecciona Conectar más tarde y vuelve desde la página Canales.
-
Crea una campaña en el idioma deseado. Usa el modo de revisión para el primer artículo. Publica un borrador y revisa Actividad y su URL pública. Comprueba título, texto, imágenes, idioma, metadatos y vista móvil.
Una conexión creada en el asistente envía artículos de todas las campañas. Para cambiarle el nombre o elegir campañas, ábrela en la página Canales de tu sitio.
El Resumen de tu sitio muestra el estado de la entrega de artículos: Conectado, Sin probar o Sin conectar.
Conectar un sitio que ya está en Structura
El diálogo Conecta tu sitio sigue funcionando para cualquier sitio headless que ya tengas. En la página Canales del sitio, selecciona Instalar en la tarjeta Entrega de artículos. Elige tu plataforma, copia el prompt en tu creador y pega la URL del receptor que te da; después sigue con los pasos 4 y 5. Si cierras el diálogo antes de probar, la conexión ya está guardada: en la pestaña Conexiones, selecciona Configurar, luego Enviar entrada de prueba y Guardar. En Listo, cambia el nombre si quieres y elige las campañas.
Prompt para tu creador
Añade un blog a mi web conservando su diseño, tipografía, colores y navegación. Crea /blog y /blog/[slug], con errores 404 reales para artículos inexistentes, páginas rastreables, metadatos, URL canónicas y entradas del sitemap.
Conecta la entrega de artículos de Structura. Sigue el contrato de entrega en https://docs.structurawp.com/en/reference/article-delivery
Añade el receptor de la forma que admita este proyecto: una ruta HTTPS POST pública dentro del sitio en /api/public/structura-articles o, solo si este proyecto no puede alojar una ruta, una Supabase Edge Function llamada structura-articles con la verificación JWT desactivada (verify_jwt = false). Añade una tabla persistente de artículos. Lee el cuerpo original de la solicitud antes de analizarlo. Guarda STRUCTURA_SIGNING_SECRET solo en los secretos del proyecto.
Verifica X-Structura-Signature con el cuerpo UTF-8 original y X-Structura-Timestamp mediante HMAC-SHA256(secret, timestamp + "." + rawBody). Rechaza marcas de tiempo con más de cinco minutos de diferencia y firmas inválidas antes de modificar datos. El único evento admitido es "post.published" en el campo event del cuerpo JSON, con schema_version 1; no hay ninguna cabecera de evento. Rechaza otros eventos o versiones de esquema con el código 422. Lee STRUCTURA_SIGNING_SECRET de las variables de entorno o los secretos del receptor solo al procesar cada solicitud; nunca lo guardes en una base de datos ni en un vault, y nunca lo expongas mediante una función, RPC o endpoint que el navegador pueda llamar.
Usa una transacción con event_id único para deduplicar y actualiza los artículos por site.id + post.id + post.locale. Rechaza revisiones antiguas. El cuerpo del artículo llega en post.html (HTML saneado), con post.markdown al lado; no existe el campo post.content. Guarda post.html y los campos SEO disponibles. post.featuredImage es null o un objeto con url y alt; usa su url para la imagen principal del artículo y para og:image, y su alt como texto alternativo. Sanea el HTML al renderizar. En el head de la página del artículo, emite cada entrada de post.jsonLd en el orden recibido, incluida la primera (BlogPosting), cada una serializada de forma segura en su propio <script type="application/ld+json">; no las combines, no descartes ninguna como duplicada, no las reescribas ni las sustituyas, ni añadas un nodo propio de tipo BlogPosting o Article. Muestra post.author (name, avatarUrl, bio, enlace a url) como firma de autor cuando no sea null. Responde 2xx solo tras guardar de forma duradera; los duplicados válidos también reciben 2xx.
No me pidas todavía el valor de STRUCTURA_SIGNING_SECRET: usa un valor provisional para tus propias pruebas y pídeme el definitivo después de responderme con la URL del receptor; lo obtengo de Structura en cuanto pegue allí tu URL. Prueba una entrega válida, una firma incorrecta y un replay; luego abre la página de un artículo entregado y comprueba que la URL canónica, la imagen destacada y cada script JSON-LD se renderizan de verdad antes de darlo por terminado. Si el hosting no puede devolver códigos de estado 404 reales ni servir /sitemap.xml como XML, dilo en lugar de añadir sustitutos del lado del cliente. Al terminar, responde con la URL pública del receptor para que pueda pegarla en Structura.Qué ocurre después
Cada publicación nueva envía un artículo, incluidos borradores aprobados más tarde. Los borradores permanecen privados. Se conserva el idioma del contenido; el idioma de notificaciones no lo traduce. Los artículos anteriores no se importan automáticamente.
Las ediciones y eliminaciones posteriores no se sincronizan. Actualiza la copia de tu web o usa la Content API para consultar el estado actual. Puede haber entregas repetidas; el receptor debe deduplicarlas.
Problemas habituales
-
Sin probar: la conexión está guardada, pero ninguna prueba ni artículo real ha llegado a tu receptor desde que la configuraste o cambiaste su URL o clave. Selecciona Enviar entrada de prueba en el paso Conectar del asistente, o abre la conexión en la pestaña Conexiones, selecciona Enviar entrada de prueba y luego Guardar. También puedes publicar un artículo nuevo y revisar Actividad y campañas.
-
HTTP 401/403: comprueba la clave, la verificación del cuerpo original y la protección del alojamiento. En Bolt, comprueba también que la función
structura-articlesno exija un JWT. -
HTTP 404: usa la URL del receptor desplegado, no la vista previa del creador.
-
HTTP 429/5xx o tiempo agotado: hay un único reintento inmediato. No existe cola duradera ni reintentos posteriores. Corrige el receptor y recupera publicaciones mediante la Content API.
-
Artículo no disponible: el artículo debe ser público, tener contenido y URL pública.
-
Artículo demasiado grande: el JSON completo debe ocupar como máximo 1 MB. Usa la Content API para artículos mayores.
-
Plan no apto: La entrega de artículos necesita una suscripción de pago activa. Comprueba tu plan y el estado del pago. No se necesita el complemento Channels.
Páginas relacionadas
Última verificación: