Validador de schema: comprueba los datos estructurados de una página o de todo un sitio
Los datos estructurados dicen a los buscadores de qué trata una página de una forma que pueden leer sin adivinar: esto es un producto, este es su precio, este es el autor. Un validador de schema lee ese marcado y te dice si se puede analizar, si usa bien el vocabulario y si está lo bastante completo para una función de búsqueda. Una página es fácil de probar. Un sitio con miles de páginas generadas por plantillas necesita la misma prueba en todas partes.
Qué comprueba un validador de schema
La validación se hace en cuatro niveles, y cada uno detecta un tipo de problema distinto:
- Sintaxis. ¿Se puede analizar el JSON-LD? ¿Está cada propiedad de microdatos dentro de un elemento? Una coma que falta o unas comillas sin escapar pueden dejar ilegible un bloque entero.
- Vocabulario. ¿Son los tipos y las propiedades términos reales de Schema.org, usados en los tipos a los que pertenecen? Una propiedad mal escrita es JSON válido pero no significa nada.
- Requisitos de la función. Google documenta las propiedades obligatorias y recomendadas de cada resultado enriquecido que admite. El marcado puede ser Schema.org válido y aun así carecer de una propiedad que Google necesita para un fragmento de producto o una ficha de evento.
- Coincidencia con la página. Las directrices de Google sobre datos estructurados piden que el marcado describa contenido que los visitantes pueden ver. Un precio en el marcado que no está en la página, o un titular distinto del visible, es un problema de calidad que ninguna comprobación de sintaxis encontrará.
La mayoría de las herramientas para una sola página cubren los tres primeros. El cuarto necesita el marcado y la página renderizada uno al lado del otro.
El validador de Schema.org y la Prueba de resultados enriquecidos de Google
Dos herramientas gratuitas prueban una página cada vez, y responden a preguntas distintas. La introducción a los datos estructurados de Google recomienda la Prueba de resultados enriquecidos mientras construyes.
| Schema Markup Validator | Prueba de resultados enriquecidos | |
|---|---|---|
| Desarrollado por | Schema.org | |
| Páginas por prueba | 1 | 1 |
| URL o código pegado | ✓ | ✓ |
| JSON-LD, microdatos, RDFa | ✓ | ✓ |
| Todo el vocabulario de Schema.org | ✓ | – |
| Opción a resultados enriquecidos de Google | – | ✓ |
| Propiedades obligatorias que faltan | – | ✓ |
| Vista previa del resultado | – | ✓ |
El Schema Markup Validator sustituyó a la antigua Herramienta de prueba de datos estructurados de Google. Úsalo para saber si el marcado es Schema.org correcto, incluidos los tipos que alimentan paneles de conocimiento o respuestas de IA pero no tienen resultado enriquecido. Usa la Prueba de resultados enriquecidos cuando el objetivo sea una función concreta de Google. Ninguno de los dos prueba un sitio entero de una vez. SEO ProCheck explica cómo depurar resultados enriquecidos que fallan con los dos.
JSON-LD, microdatos y RDFa
Google lee los tres formatos y dice que son igual de válidos si están bien, pero recomienda JSON-LD porque va en un solo bloque script, separado del HTML, y es el más fácil de mantener correcto en todas las plantillas. Un bloque Product mínimo tiene este aspecto:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Los microdatos y RDFa ponen los mismos datos en atributos del HTML visible. Eso mantiene el marcado cerca del contenido, pero un cambio de plantilla en el HTML puede romperlo sin que nadie lo note. Uses el que uses, usa uno por elemento; describir el mismo producto dos veces en dos formatos invita a que no coincidan.
Errores habituales en los datos estructurados
- JSON roto. Una coma final, unas comillas tipográficas pegadas desde un documento o un salto de línea sin escapar dentro de una cadena.
- Falta @context o @type. Sin ellos, un analizador no sabe qué describe el bloque.
- Faltan propiedades obligatorias. Mira la tabla de abajo.
- Marcado que no coincide con la página. Un precio que cambió en la página pero no en el marcado.
- Valores caducados. Una oferta cuyo priceValidUntil ya ha pasado, o un dateModified anterior al datePublished.
Propiedades obligatorias de algunas funciones habituales, según la galería de búsqueda de Google:
| Tipo | Obligatorias para Google |
|---|---|
| Fragmento de producto | name, más offers, review o aggregateRating |
| Event | name, startDate, location |
| Recipe | name, image |
| BreadcrumbList | itemListElement: name, position, item |
| Article | 0 (todas recomendadas) |
Algunos marcados son válidos pero ya no consiguen lo que conseguían:
| Marcado | Cambio | Desde |
|---|---|---|
| data-vocabulary.org | No admitido | 2021 |
| HowTo | Sin resultado enriquecido | Septiembre de 2023 |
| FAQPage | Solo sitios gubernamentales y de salud | Agosto de 2023 |
| FAQPage | Sin resultado enriquecido | Mayo de 2026 |
Por qué no basta con una página
Los datos estructurados casi siempre los generan plantillas. Cuando se rompen, se rompen en todas las páginas que sirve la plantilla, o en el subconjunto en el que un campo está vacío. Probar la página de producto que abres por casualidad no te mostrará que 300 productos no tienen precio porque su campo de precio es un rango, ni que los artículos de un autor no tienen marcado de autor.
Tres cosas solo aparecen al revisar todo un sitio:
- Cobertura. Qué grupos de páginas llevan marcado y qué páginas de un grupo no tienen lo que tienen las demás.
- Casos límite. Campos vacíos, caracteres raros y valores que solo tienen algunos registros.
- Deriva. Marcado que era válido en el lanzamiento y dejó de serlo después de una publicación. La documentación de Google recomienda vigilar los informes de resultados enriquecidos después de cada despliegue precisamente por eso.
Cómo validar el schema en todo un sitio
- Rastrea el sitio y extrae los datos estructurados de todas las páginas HTML. Si parte del marcado lo inyecta JavaScript, renderiza también las páginas, como se describe en la guía del crawler SEO para JavaScript.
- Corrige primero los errores de sintaxis. No se puede comprobar nada más en un bloque que no se puede analizar.
- Agrupa las páginas por plantilla y enumera los tipos que lleva cada grupo. Busca páginas a las que les falte un tipo que tiene la mayor parte de su grupo.
- Revisa las propiedades obligatorias de las funciones que quieres y después las recomendadas.
- Compara el marcado con el texto visible: los nombres, titulares y precios deberían aparecer en la página.
- Comprueba por muestreo en la Prueba de resultados enriquecidos una página por plantilla, para confirmar lo que ve Google.
- Vigila Search Console después de cada publicación: los informes de resultados enriquecidos y la Inspección de URLs muestran lo que Google encontró en su propio rastreo.
Los datos estructurados son un paso del checklist de auditoría SEO técnica, y un marcado limpio también ayuda a los sistemas de IA a leer una página, como explica la guía del crawler SEO con IA.
Valida los datos estructurados con Neova
La categoría Datos estructurados de Neova marca el schema de cada página como válido, con advertencias o con errores, añade una columna Tipos de schema y da un veredicto para cada tipo en el panel de la URL. Lee JSON-LD, microdatos y RDFa de todas las páginas HTML del rastreo. Algunas de las comprobaciones:
- Datos estructurados con errores de sintaxis, para JSON-LD que no se puede analizar o al que le falta @context o @type
- A los datos estructurados les faltan propiedades obligatorias o difieren del texto visible, para las funciones que documenta Google
- A los datos estructurados les faltan propiedades recomendadas, que también señala el marcado de data-vocabulary.org
- El precio del producto en los datos estructurados no aparece en la página HTML y La fecha priceValidUntil del Offer ya ha pasado
- Las fechas no coinciden entre los datos estructurados, el lastmod del sitemap o Last-Modified
- Falta un tipo de datos estructurados habitual en su grupo de páginas y A una página HTML le falta el marcado de resultados enriquecidos que lleva su grupo de páginas
- Al marcado Organization o Person le faltan propiedades identificativas
- Página HTML sin datos estructurados, que también lee el HTML renderizado cuando el rastreo lo renderizó
- Resultado enriquecido no válido, desde la Inspección de URLs de Google Search Console
Como Neova detecta los grupos de páginas a partir del HTML, un problema de plantilla aparece como un grupo con el mismo aviso en lugar de miles de filas sueltas. Las dudas sobre tipos y formatos se responden en las preguntas frecuentes sobre schema de SEO ProCheck. Consulta las Funciones o descarga Neova; el plan Free rastrea 1.000 URL con todas las comprobaciones.
Preguntas
¿Qué es un validador de schema?
Una herramienta que lee los datos estructurados de una página, en JSON-LD, microdatos o RDFa, y comprueba que se pueden analizar, que usan bien los tipos y propiedades de Schema.org y, en algunas herramientas, que tienen lo que exige una función de búsqueda.
¿Qué diferencia hay entre el Schema Markup Validator y la Prueba de resultados enriquecidos?
El Schema Markup Validator de validator.schema.org comprueba el marcado con todo el vocabulario de Schema.org. La Prueba de resultados enriquecidos de Google comprueba a qué resultados enriquecidos de Google puede optar una página y qué propiedades obligatorias o recomendadas faltan.
¿Garantizan los datos estructurados válidos un resultado enriquecido?
No. Google dice que el marcado válido hace que una página pueda optar, no que lo garantice. Decide si muestra un resultado enriquecido según la consulta, la página y sus directrices de calidad.
¿Puedo validar el schema de todo un sitio?
No con las herramientas para una sola página. Un crawler que extrae y comprueba los datos estructurados de todas las páginas muestra los problemas de plantilla, el marcado que falta y las páginas que difieren de su grupo, y después compruebas por muestreo una página por plantilla en la Prueba de resultados enriquecidos.
¿Qué formato de datos estructurados debería usar?
Google lee JSON-LD, microdatos y RDFa y recomienda JSON-LD, porque va en un solo bloque separado del HTML y es el más fácil de mantener.