Guía de implementación de datos estructurados Schema.org (JSON-LD): haz que la IA y Google entiendan tu sitio web
Los motores de IA y Google no "leen" tu página web, la "analizan". Un bloque de datos estructurados JSON-LD con el formato correcto equivale a decirles directamente, en un lenguaje que las máquinas entienden: qué tipo de empresa es esta, quién escribió este artículo, cuánto cuesta este producto y qué preguntas frecuentes aparecen en esta página. Sin ellos, la IA solo puede adivinar; con ellos, tus probabilidades de ser identificado y citado correctamente aumentan enormemente. Esta guía te lleva de cero a implementar los tipos más comunes, colocarlos en el lugar correcto y validarlos con confianza.
¿Qué son los datos estructurados y por qué usar JSON-LD?
Los datos estructurados son un marcado escrito según el vocabulario común de Schema.org, que usa pares clave-valor legibles por máquinas para indicarles a los buscadores y a los motores de IA "qué representa el contenido de esta página". Toma una cadena como "Juan Pérez, 0912-345-678": una persona entiende que es un contacto y un número de teléfono, pero la máquina necesita que marques explícitamente el name y el telephone para no interpretarlos mal.
Hay tres formatos de implementación (JSON-LD, Microdata y RDFa), pero tanto Google como las prácticas más extendidas hoy recomiendan JSON-LD. La razón es que reúne todo el marcado en un único bloque <script> independiente, así que no tienes que entrelazarlo con tus etiquetas HTML. Es el más fácil de mantener, el que menos probablemente choca con tu maquetación y el más fácil de analizar de forma estable por los rastreadores de IA.
¿Dónde va el JSON-LD en la página?
Envuelve el marcado en un bloque <script type="application/ld+json">. Se reconoce tanto si lo colocas en el <head> como en el <body> de la página, pero por convención va en el <head>. Una página puede tener varios bloques JSON-LD, y también puedes agrupar varias entidades juntas con un único arreglo @graph; ambos enfoques son válidos.
El principio clave es este: los datos estructurados deben generarse en el lado del servidor y existir en el HTML original. La mayoría de los rastreadores de recuperación de IA no ejecutan JavaScript, así que si tu JSON-LD se inyecta dinámicamente con JS solo después de que el front-end carga, lo más probable es que el rastreador de IA lea un cascarón vacío sin marcado. Usa "Ver código fuente" (View Source) en lugar del panel Elements de las herramientas de desarrollo para confirmar que realmente está en la respuesta original.
Organization y LocalBusiness: define quién eres
Esta es la pieza que deberías priorizar en todo tu sitio, y normalmente va en la página de inicio. Define tu entidad de marca y es la base central para que la IA responda "quién es esta empresa y si se puede confiar en ella". Si tienes una tienda física o un área de servicio, reemplaza Organization por el más preciso LocalBusiness (o un subtipo como Restaurant o Store) y añade tu dirección y horario de atención.
- Campos obligatorios de Organization: name (nombre de la marca), url (sitio oficial) y logo (la URL de la imagen del logotipo).
- sameAs: un arreglo con tus enlaces oficiales, como Facebook, Instagram, LinkedIn y Wikipedia. Es la clave para "unir" tus identidades de marca dispersas en una sola entidad, y reduce enormemente la probabilidad de que la IA te confunda con otra.
- Campos adicionales de LocalBusiness: address (con la estructura PostalAddress, dividida en calle/ciudad/código postal), telephone, openingHours, geo (latitud y longitud) y priceRange.
- contactPoint: indica tu número de teléfono de soporte, el email y los idiomas de atención, para que la IA pueda encontrarte cuando responda preguntas sobre contacto.
Article, Product, BreadcrumbList: elige el schema correcto según el tipo de página
Las distintas páginas usan distintos tipos, y el principio es "marca de qué trata principalmente esta página". Los blogs y las noticias usan Article (o BlogPosting/NewsArticle); las páginas de producto usan Product; y cualquier página con jerarquía debería añadir BreadcrumbList.
- Article/BlogPosting: headline, author (usa Person u Organization, no solo texto plano), datePublished, dateModified, image y publisher. El autor y las fechas son señales importantes que la IA usa para juzgar qué tan fresco y autorizado es el contenido.
- Product: name, image, description, brand y offers (que contiene price, priceCurrency y availability). Si tienes valoraciones, añade también aggregateRating y review, pero las puntuaciones deben coincidir con las reseñas que realmente se muestran en la página.
- BreadcrumbList: usa itemListElement para listar en orden la ruta de migas de pan (Inicio › Categoría › Esta página), ayudando a los motores a entender la estructura de tu sitio y dónde encaja esta página dentro de él.
- Un truco para elegir el tipo: una misma página puede tener varios tipos a la vez (por ejemplo, una reseña de producto que es a la vez Article y Product), y solo tienes que agruparlos con @graph.
¿Quieres saber qué puntaje tiene tu sitio para la IA?
Escaneo gratis: obtén tu puntaje de legibilidad para IA (0–100) y arreglos listos para pegar al instante.
Análisis GEO gratis →FAQPage: la jugada más directamente útil para el GEO
Si solo quieres empezar con un tipo que pueda influir de inmediato en las citas de la IA, elige FAQPage. Empareja cada "pregunta y respuesta" en un formato legible por máquinas, lo que encaja perfectamente con la forma en que los motores de IA buscan "un fragmento de contenido que puedan usar directamente como respuesta". Es un paso con una relación coste-beneficio excelente.
El método consiste en usar mainEntity para listar varias entradas Question, con una acceptedAnswer (de tipo Answer, con la respuesta en el campo text) debajo de cada una. La regla de oro: las preguntas y respuestas del marcado deben ser contenido que los usuarios puedan ver realmente en la página; no pueden existir solo en el JSON-LD. La política de Google exige explícitamente que el contenido de las FAQ sea visible en la página; de lo contrario, cuenta como contenido oculto que infringe las políticas.
¿Cómo validar? Tres comprobaciones imprescindibles
Valida siempre una vez terminado, porque un solo nombre de campo mal escrito o una coma de menos puede hacer que se ignore todo el bloque de marcado. La validación tiene dos niveles: si la sintaxis es correcta y si reúne las condiciones para activar Rich Results.
- Schema Markup Validator (validator.schema.org): comprueba si la sintaxis de Schema.org en sí es correcta. Funciona para todos los tipos, no solo los que admite Google.
- Google Rich Results Test (search.google.com/test/rich-results): pega una URL o el código para ver si Google lo reconoce y si puede obtener resultados enriquecidos, y enumera los errores y advertencias.
- El informe de "Resultados enriquecidos" de Search Console: una vez en producción, monitorea de forma continua el estado y los errores que Google realmente detecta, lo que refleja la realidad mejor que una prueba puntual.
- No olvides usar "Ver código fuente" para confirmar que el marcado aparece realmente en el HTML que devuelve el servidor, y no que depende solo de la inyección con JS.
Los cinco errores más comunes (sobre todo el primero, que se trata como spam)
Hacer mal los datos estructurados es peor que no hacerlos: en el mejor de los casos se ignoran, en el peor se consideran manipulación. Estas son las cinco trampas en las que más se cae.
- Marcado que no coincide con el contenido: el JSON-LD declara una valoración de cinco estrellas que no está en la página, o respuestas de FAQ que no se ven en la página. Google lo trata como spam y puede hacer que los datos estructurados de todo tu sitio pierdan elegibilidad. El marcado debe reflejar fielmente el contenido real de la página.
- Usar el tipo o los campos equivocados: marcar un producto como Article, rellenar author con una cadena de texto plano en lugar de un Person/Organization, o dejar price sin priceCurrency, impiden que los motores lo analicen correctamente.
- Depender de la inyección dinámica con JavaScript: los rastreadores de IA, y en algunos escenarios, no pueden leerlo, así que es esfuerzo desperdiciado. Genéralo siempre en el lado del servidor.
- Entidades inconsistentes: la página de inicio dice "KKpower", otras páginas dicen "KK Power" y los enlaces sociales tampoco cuadran, lo que dificulta que la IA las una en una sola marca. Mantén consistentes el name, la url y el sameAs.
- Exceso de marcado y relleno: meter a la fuerza absolutamente todo lo de la página en el schema, o declarar la misma entidad repetidamente, solo aumenta el riesgo de errores y de que se considere manipulación. Marca solo lo importante y lo real.
Preguntas frecuentes
Q. ¿Tengo que usar JSON-LD para los datos estructurados? ¿Sirve Microdata?
Microdata y RDFa siguen siendo válidos sintácticamente, pero tanto Google como las prácticas más extendidas hoy recomiendan JSON-LD. Reúne el marcado en un bloque <script> independiente, así que no tienes que entrelazarlo con tus etiquetas HTML; es el más fácil de mantener, el que menos probablemente choca con tu maquetación y el más fácil de analizar de forma estable por los rastreadores de IA. Para cualquier sitio nuevo, ve directamente con JSON-LD.
Q. Si añado datos estructurados, ¿Google me dará con seguridad Rich Results (estrellas, FAQ desplegables)?
No hay garantía. El marcado correcto solo "otorga elegibilidad"; que los resultados enriquecidos se muestren realmente lo decide el algoritmo de Google, que tiene en cuenta la calidad del contenido, el cumplimiento de las políticas, el contexto de la consulta y más. Pero aunque no active Rich Results visuales, los datos estructurados correctos siguen ayudando a los buscadores y a los motores de IA a entender y citar tu contenido, así que el valor nunca se desperdicia.
Q. Las preguntas y respuestas del marcado FAQPage, ¿tienen que verse en la página?
Sí, es un requisito obligatorio. La política de Google exige que las preguntas y respuestas de una FAQ sean contenido genuinamente visible para los usuarios en la página; si solo está escrito en el JSON-LD pero no se ve en la página, cuenta como contenido oculto que infringe las políticas, lo que puede hacer que tus datos estructurados pierdan elegibilidad o incluso afectar a todo tu sitio. El marcado debe corresponderse fielmente con lo que la página presenta realmente.
Q. ¿Equivocarme en los datos estructurados puede perjudicar a mi sitio web?
Sí. El caso más grave es el "marcado que no coincide con el contenido" (como reseñas falsas o FAQ que no se ven en la página), que se trata como manipulación y puede hacer que los datos estructurados de tu sitio queden descalificados. Otros problemas comunes, como usar el tipo equivocado, escribir mal los campos o depender de la inyección con JS de modo que los rastreadores no puedan leerlo, suelen ser "inválidos pero inofensivos", y los motores simplemente los ignoran. El principio es: mejor marcar poco y correctamente que marcar mucho y falsearlo.
Q. ¿Qué tipo de schema debería priorizar?
Empieza con dos. Primero, Organization en la página de inicio (usa LocalBusiness si tienes una tienda física o un área de servicio) para definir tu entidad de marca y tu información de contacto; segundo, FAQPage en las páginas de contenido, porque su formato de pregunta y respuesta es el que más se parece a la forma en que los motores de IA extraen respuestas, lo que lo hace lo más directamente eficaz para ser citado. Después, añade Article, Product y BreadcrumbList según el tipo de página.
Q. ¿Cómo confirmo que mis datos estructurados realmente se están leyendo?
Tres pasos: primero, usa el Schema Markup Validator (validator.schema.org) para confirmar que la sintaxis es correcta; luego, usa el Google Rich Results Test para confirmar que Google lo reconoce y comprobar si puede activar resultados enriquecidos; una vez en producción, usa el informe de resultados enriquecidos de Search Console para monitorear de forma continua. Por último, asegúrate de usar la opción "Ver código fuente" de tu navegador para confirmar que el JSON-LD aparece en el HTML original que devuelve el servidor, y no que solo lo inyecta el JavaScript del front-end.
Pon a prueba lo aprendido en tu sitio en 10 segundos
Escaneo gratis: obtén tu puntaje de legibilidad para IA (0–100) y arreglos listos para pegar al instante.
Análisis GEO gratis →