$ man how-to/schema-markup-for-geo

El schema markup son datos estructurados incrustados en tus páginas usando JSON-LD que les dicen a las máquinas qué tipo de contenido están viendo. Sin schema, un motor de IA tiene que adivinar si una página es una definición, un tutorial, un post de blog o una página de producto. Con schema, se lo dices explícitamente. Las páginas con 3 o más tipos de schema tienen aproximadamente un 13% más de probabilidad de citación por motores de IA. El 96% de las citaciones de AI Overview provienen de fuentes con señales fuertes de E-E-A-T, y el schema es cómo haces esas señales legibles por máquinas. Esto no es opcional para GEO. Es infraestructura.

CODE

Haz coincidir tu schema con tu tipo de contenido. Los términos de conocimiento y entradas de glosario usan DefinedTerm o Article más FAQPage más BreadcrumbList. Las guías how-to usan HowTo con elementos step más BreadcrumbList. Las entradas wiki usan TechArticle o Article más FAQPage. Los posts de blog usan BlogPosting con author y datePublished. Cada página en cada sitio también debe incluir schemas de Organization, Person (para el autor) y WebSite. El paquete npm schema-dts te da tipos de TypeScript para todo el vocabulario de schema.org. Instálalo y obtienes autocompletado y verificación de tipos para cada propiedad de schema. No más adivinar si es datePublished o publishDate. Los tipos aplican la corrección en tiempo de build.

CODE

En Next.js, inyecta schema JSON-LD como una etiqueta script en tu página o componente de layout. Crea un componente reutilizable que tome datos de schema tipados y renderice la etiqueta script. En ShawnOS, el schema se genera a partir de los mismos objetos de datos TypeScript que renderizan el contenido de la página. El objeto de datos del término de conocimiento contiene el nombre, definición y términos relacionados. El componente de schema lee esos mismos campos y produce un bloque JSON-LD de DefinedTerm. Esto significa que el schema y el contenido nunca pueden desfasarse. Cuando actualizas una definición en engineering-terms.ts, el schema se actualiza automáticamente en el siguiente build. Sin sincronización manual. Sin campo separado de CMS para datos de schema. Una sola fuente de verdad renderizada de dos formas: una vez como contenido visible, una vez como datos estructurados invisibles.

PRO TIP

Usa el Rich Results Test de Google para validar páginas individuales. Usa el Schema Markup Validator para verificaciones comprehensivas contra la especificación de schema.org. Ejecuta ambos después de cada despliegue que cambie la estructura de contenido. Errores comunes: campos requeridos faltantes (HowTo necesita al menos un elemento step), tipos que no coinciden (usar Article cuando DefinedTerm es más específico) y schema huérfano (datos estructurados que no coinciden con el contenido visible de la página). Google advierte explícitamente contra schema que no refleja lo que los usuarios ven en la página. El schema debe describir tu contenido, no inventar contenido que no existe.