Marcado Schema.org automático: @graph conectado, FAQ, Speakable

Cada página de un sitio AliothPress lleva un @graph de Schema.org completo en JSON-LD: entidades Organization, Person, WebSite y Article conectadas entre sí por identificador, más marcado FAQPage, Speakable y CollectionPage donde el contenido lo pide. Nada se pega, se instala ni se mantiene a mano. El grafo se genera en cada renderizado a partir de los ajustes del sitio, los perfiles de autor y el propio contenido, en cada uno de los 31 idiomas, así que el marcado nunca puede desviarse de las páginas que describe.

Un grafo conectado, no fragmentos sueltos

La mayoría de los datos estructurados de la web llegan como fragmentos desconectados: un Article por aquí, una Organization por allá, y nada hace referencia a nada. Las máquinas ven piezas, no un editor detrás. AliothPress construye en cambio un grafo por página. El campo author del nodo Article apunta al nodo Person por @id, su publisher apunta al nodo Organization, y el nodo WebSite declara esa misma Organization como su editor. Los buscadores y los motores de respuesta de IA resuelven esas referencias en una sola imagen verificable: este contenido, de esta persona, de esta organización. La verificación de entidades es exactamente lo que los sistemas de IA comprueban antes de citar una fuente, y el grafo conectado es lo que la hace comprobable.

Organization y Person: alimentados por ajustes y perfiles

La entidad Organization se construye desde los Ajustes del sitio: nombre del sitio, logotipo (emitido como ImageObject con dimensiones) y enlaces sameAs a Wikipedia, Wikidata, LinkedIn y perfiles sociales, para que las máquinas puedan confirmar que la organización existe más allá de tu propio dominio.

La entidad Person se construye desde el perfil de usuario del autor: nombre visible, biografía, avatar y enlaces sameAs a LinkedIn, una web personal y GitHub. Cada autor del equipo recibe automáticamente su propia entidad verificable. Cuando una entrada debe acreditar un nombre distinto del de la cuenta que la creó, un campo dedicado de autor de schema en la entrada o la página sobrescribe el nombre visible en el marcado, sin tocar la cuenta.

Qué campo de los ajustes alimenta qué entidad se explica al detalle en Ajustes del CMS y perfil de autor, explicados.

Entradas y páginas: el tipo correcto, completo cada vez

Las entradas son BlogPosting por defecto y las páginas WebPage, y un desplegable en el editor cambia cualquiera de ellas al tipo que encaje con el contenido: Article, NewsArticle, TechArticle, HowTo, AboutPage, ContactPage, CollectionPage o FAQPage. Sea cual sea el tipo, el nodo llega completo:

• Identidad: la URL canónica sirve como @id del nodo, así que los ajustes de canónica y los datos estructurados siempre coinciden
• Campos de contenido: headline desde el título, descripción desde la meta description o el extracto, keywords desde las meta keywords
• Imagen destacada como ImageObject con anchura, altura y el texto alternativo como pie, siempre como URL absoluta
• Fechas: datePublished y dateModified desde los datos reales de publicación, actualizadas cada vez que el contenido lo hace
• Idioma: inLanguage tomado del idioma del contenido, correcto en cada traducción
• Conexiones: author, publisher y mainEntityOfPage cableados en el grafo

Ocultar el autor o la fecha en la página pública no los quita del marcado: los metadatos siguen en el HTML para los buscadores aunque el diseño los mantenga fuera de la vista.

FAQPage: marcado que siempre coincide con la página visible

El marcado de FAQ nace de dos fuentes: el editor de FAQ que traen todas las entradas y páginas, y los bloques de acordeón del Page Builder. Ambos renderizan un acordeón de FAQ visible para los lectores humanos y emiten el nodo FAQPage correspondiente con entidades Question y acceptedAnswer para las máquinas. Como el marcado y el acordeón salen de los mismos datos guardados, no pueden contradecirse, y eso cierra el clásico caso de penalización: marcado de FAQ para contenido que no está en la página. Los pares de pregunta y respuesta son el formato que los motores de respuesta de IA recogen con más ganas, así que este es también el camino más corto para que te citen.

Speakable: señalar a las máquinas dónde está la respuesta

Cada entrada y página lleva una SpeakableSpecification que apunta al primer párrafo del contenido. Esto encaja a propósito con el estilo answer-first del Asistente de IA, que pone una respuesta directa al principio del contenido generado: el marcado Speakable les dice entonces a los asistentes de voz y a los motores de respuesta exactamente dónde está esa respuesta. Escribe (o genera) un primer párrafo fuerte y el marcado se lo sirve a las máquinas en bandeja.

El nodo del sitio y las páginas de archivo

Un nodo WebSite declara el nombre del sitio, el lema, el logotipo, el editor y la lista completa de sus idiomas activos. Las páginas de etiquetas y categorías emiten un nodo CollectionPage con una ItemList de las entradas que contienen, cada una con posición, nombre y URL, así que los archivos se leen como colecciones curadas y no como muros de enlaces.

Correcto por construcción

Tres detalles de implementación mantienen la salida limpia ante cualquier validador. Toda URL del grafo se fuerza a absoluta, así que las rutas relativas de los campos de la base de datos nunca se cuelan en el JSON-LD. Las propiedades que Schema.org no define para un tipo se dejan fuera a propósito, incluso las tentadoras: las alternativas de idioma, por ejemplo, se señalan con etiquetas hreflang, que es donde deben ir, no con propiedades inválidas en WebPage. Y el grafo entero se regenera en cada renderizado, así que renombrar un autor, cambiar el logotipo o editar una entrada actualiza el marcado en todas partes al instante, sin caché de afirmaciones caducadas y sin nada en la lista de tareas de nadie.

Los datos estructurados son la forma en que las máquinas deciden qué es tu sitio y si citarlo, y solo funcionan cuando están completos, conectados y al día. AliothPress genera el @graph de Schema.org completo, desde las entidades Organization y Person con verificación sameAs hasta el marcado FAQPage, Speakable y CollectionPage, automáticamente en cada página y en los 31 idiomas. La capa más amplia para motores de respuesta, con llms.txt y contenido answer-first, se explica en CMS con SEO, AEO y llms.txt integrados. Para ver tu propio grafo, instala siguiendo la guía de instalación de AliothPress, publica una entrada y pasa la página por cualquier validador de datos estructurados.