Los datos estructurados indican a los motores de búsqueda qué significa tu contenido, no solo qué dicen las palabras, sino si una página es un producto, un artículo, una receta o unas preguntas frecuentes. Hacerlo bien hace que Google muestre tu contenido como resultados enriquecidos: valoraciones con estrellas, acordeones de FAQ, rutas de migas de pan y carruseles de pasos. Hacerlo mal hace que el marcado se ignore silenciosamente. Esta guía cubre todos los métodos para comprobar los datos estructurados de cualquier sitio web, desde la inspección del código fuente hasta la validación automatizada en CI.
¿Qué son los datos estructurados?
Los datos estructurados son metadatos legibles por máquinas incrustados en una página web que ayudan a los motores de búsqueda a entender el contenido más allá del texto visible. El formato dominante es JSON-LD: una etiqueta script de notación de objetos JavaScript colocada en el `<head>` de una página, que usa vocabulario de schema.org para describir entidades como artículos, productos, eventos, recetas y organizaciones.
Cuando un motor de búsqueda rastrea una página, extrae estos bloques de esquema y los usa para generar resultados enriquecidos: listados de búsqueda mejorados que muestran valoraciones con estrellas, rangos de precios, fechas de eventos, acordeones de FAQ y navegación de migas de pan directamente en la SERP. Los resultados enriquecidos logran consistentemente tasas de clic más altas que los listados estándar de enlace azul porque transmiten más información de un vistazo.
Los tres formatos de datos estructurados
- JSON-LD: una etiqueta `<script type="application/ld+json">` autónoma que contiene un objeto JSON. Google recomienda este formato: es el más fácil de añadir, validar y mantener sin tocar el HTML de la página.
- Microdatos: atributos de esquema (`itemscope`, `itemtype`, `itemprop`) añadidos directamente a los elementos HTML. Están fuertemente acoplados a la estructura de la página: más difíciles de validar y actualizar.
- RDFa: atributos de datos enlazados (`typeof`, `property`) añadidos a elementos HTML. Muy usado en algunas plataformas CMS pero menos común que JSON-LD en implementaciones nuevas.
Note
Cómo comprobar los datos estructurados
Hay cuatro métodos prácticos para comprobar los datos estructurados de una página, cada uno adecuado a situaciones distintas. Los métodos más rápidos no requieren ninguna herramienta; los más exhaustivos necesitan un validador y el entorno de pruebas de Google.
Método 1: ver el código fuente de la página
Haz clic derecho en cualquier página del navegador y elige Ver código fuente (Ctrl+U / Cmd+U). Pulsa Ctrl+F para abrir el buscador y busca `application/ld+json`. Cada resultado es un bloque de datos estructurados. Esto te dice de inmediato si existen datos estructurados en la página y te permite copiar el JSON para validarlo. En páginas que renderizan contenido con JavaScript, ver el código fuente muestra solo el HTML inicial; usa DevTools para la salida renderizada.
Método 2: panel Elements de las DevTools
Abre las DevTools de Chrome (F12), ve a la pestaña Elements y busca `ld+json` en el árbol de elementos. Esto muestra los datos estructurados tal y como los renderiza el navegador actualmente, incluidos los bloques inyectados por JavaScript tras la carga de la página. Es el enfoque correcto para React, Next.js o cualquier framework que añada datos estructurados en el cliente o mediante renderizado en servidor.
Método 3: Validador de Datos Estructurados (el más rápido para desarrollo)
Copia un bloque JSON-LD y pégalo en el validador de datos estructurados. Valida la sintaxis JSON, comprueba las declaraciones `@context` y `@type`, y marca las propiedades obligatorias faltantes para el tipo de esquema declarado, todo en tu navegador sin enviar una URL ni esperar un rastreo. Es el ciclo más rápido durante el desarrollo porque puedes corregir y revalidar en segundos.
Método 4: la Prueba de Resultados Enriquecidos de Google
Envía la URL de tu página en vivo a la Prueba de Resultados Enriquecidos de Google en `search.google.com/test/rich-results`. Google descarga la página, extrae todos los datos estructurados e informa de los tipos de resultado enriquecido para los que la página es elegible. Es la prueba autoritativa para la elegibilidad de resultados enriquecidos, pero requiere una URL en vivo y tarda 5-30 segundos por prueba. Úsala cuando la validación local esté limpia.
Validador de Datos Estructurados
Valida cualquier bloque de datos estructurados JSON-LD por sintaxis, propiedades obligatorias y cumplimiento de schema.org, en el navegador y sin necesidad de URL.
Validar el marcado JSON-LD
La validación JSON-LD tiene dos capas distintas: la validación de sintaxis (¿el JSON es estructuralmente válido?) y la validación de esquema (¿el contenido cumple las propiedades obligatorias y recomendadas del tipo de schema.org?). Ambas capas deben pasar antes de que un bloque de datos estructurados sea útil.
Inspecciona la página en busca de bloques JSON-LD
Haz clic derecho en la página y elige Ver código fuente. Busca `application/ld+json`. Copia el objeto JSON completo de dentro de la etiqueta script, desde la llave de apertura hasta la de cierre. Si hay varios bloques, copia cada uno por separado para validarlo.
Valida la sintaxis con el validador JSON-LD
Pega el bloque copiado en el validador JSON-LD. Comprueba que el JSON está bien formado, que `@context` está fijado a `https://schema.org` y que `@type` referencia un tipo reconocido de schema.org. Los errores de sintaxis se informan con números de línea; las advertencias de tipo desconocido identifican tipos de esquema con pocas probabilidades de producir resultados enriquecidos.
Comprueba las propiedades obligatorias del tipo declarado
Cada tipo de esquema tiene propiedades obligatorias y recomendadas. Un esquema `Product` exige `name` y `offers` o `review` para ser elegible como resultado enriquecido. Un `Article` exige `headline`, `author` y `datePublished`. El validador de datos estructurados comprueba el `@type` declarado y marca cada propiedad obligatoria que falte o esté mal formateada.
Prueba la elegibilidad con la herramienta de Google
Cuando la validación local esté limpia, envía la URL de la página a la Prueba de Resultados Enriquecidos de Google. Revisa la lista de tipos de esquema detectados y confirma que cada uno aparece como elegible y no marcado con errores. Atiende las advertencias de "Recomendado" de propiedades que mejoran la calidad de los resultados enriquecidos aunque no los bloqueen.
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "How to Check Structured Data on a Website",
"author": {
"@type": "Person",
"name": "Devvrat Hans",
"url": "https://abacktools.com"
},
"datePublished": "2026-06-11",
"dateModified": "2026-06-11",
"publisher": {
"@type": "Organization",
"name": "Aback Tools",
"url": "https://abacktools.com"
}
}Tip
Errores comunes de datos estructurados
La mayoría de los errores de datos estructurados caen en categorías previsibles. Saber qué significa cada tipo de error, y por qué importa, te permite corregir en el orden adecuado: primero la sintaxis, después las propiedades obligatorias y al final las mejoras recomendadas.
Propiedades obligatorias ausentes
Google define propiedades obligatorias para cada tipo de esquema que soporta resultados enriquecidos. Si falta alguna propiedad obligatoria, todo el esquema queda fuera de su función de resultado enriquecido. Ejemplos comunes: `Product` sin `name` ni `offers`, `Recipe` sin `name` ni `recipeIngredient`, `Event` sin `name`, `startDate` o `location`. El comprobador de completitud de esquema Product audita específicamente los esquemas Product contra todos los campos obligatorios y recomendados de Google.
Tipos de valor incorrectos
Las propiedades de schema.org esperan tipos de valor concretos. Las propiedades `url` deben ser URLs absolutas que empiecen por `https://`; `ratingValue` debe ser un número (no una cadena como `"4.5"`); `datePublished` debe ser una cadena de fecha ISO 8601 válida. Pasar una cadena donde se espera un número, o una ruta relativa donde se exige una URL absoluta, provoca un error de incompatibilidad de tipo que impide leer el esquema correctamente.
Tipo de esquema y contenido de la página incoherentes
Google exige que los datos estructurados reflejen con exactitud el contenido visible de la página. Colocar marcado `FAQPage` en una página que no muestra visiblemente preguntas y respuestas, o añadir marcado `Product` a una página de categoría sin detalles concretos de producto, viola las directrices de datos estructurados de Google y puede derivar en acciones manuales contra la elegibilidad de resultados enriquecidos.
| Tipo de error | Ejemplo | Impacto | Cómo corregirlo |
|---|---|---|---|
| Propiedad obligatoria ausente | Product sin name | Bloquea el resultado enriquecido | Añade la propiedad |
| Tipo de valor erróneo | ratingValue: "4.5" (cadena) | Esquema ignorado | Usa un número: 4.5 |
| URL relativa en campo url | image: /foto.jpg | Error de validación | Usa URL absoluta HTTPS |
| Formato de fecha inválido | datePublished: "junio 2026" | Fecha no interpretada | Usa formato YYYY-MM-DD |
| @type desconocido | @type: "BlogPosting2" | Esquema no reconocido | Usa el tipo exacto de schema.org |
| @context ausente | Sin declaración @context | Esquema no extraído | Añade el contexto schema.org |
| Contenido incoherente | FAQPage en página sin FAQ | Riesgo de acción manual | Ajusta el esquema al contenido |
Warning
Comprobación por tipo de esquema
Los distintos tipos de esquema tienen propiedades obligatorias diferentes, presentaciones de resultados enriquecidos diferentes y herramientas de validación más adecuadas para cada uno. Así se abordan los tipos más usados.
FAQPage y HowTo
FAQPage es uno de los tipos de esquema con mayor impacto en el CTR orgánico: un esquema FAQPage válido se renderiza como un acordeón desplegable directamente en los resultados de Google, mostrando preguntas y respuestas sin necesidad de clic. Usa el generador de esquema FAQ para producir marcado FAQPage limpio a partir de pares de pregunta y respuesta, y valida la salida con el validador JSON-LD. Para contenido instructivo paso a paso, el generador de esquema HowTo construye marcado HowTo válido con bloques `HowToStep` bien estructurados.
BreadcrumbList
El marcado BreadcrumbList genera la ruta de migas de pan mostrada bajo el título de la página en los resultados de Google, sustituyendo la URL en crudo por una jerarquía legible. Cada `ListItem` exige un `name` y una URL `item`. Usa el generador de esquema Breadcrumb para generar JSON-LD de BreadcrumbList desde una ruta de URL o entradas manuales, listo para insertar directamente en tu plantilla de página.
Organization y Article
El esquema Organization establece la identidad de tu sitio para el grafo de conocimiento de Google: nombre, logotipo, información de contacto y perfiles sociales. El validador de esquema Organization comprueba que todos los campos recomendados están presentes y correctamente formateados. Para contenido editorial, el esquema Article con `author`, `datePublished` y `publisher` aumenta la elegibilidad para Google News, Top Stories y Discover, lo que puede llevar tráfico significativo a páginas de noticias y blogs.
Reseñas y valoraciones agregadas
Las valoraciones con estrellas en los resultados provienen de `AggregateRating` anidado dentro de un esquema `Product`, `LocalBusiness` o `Recipe`. El `ratingValue` debe ser un número, `reviewCount` debe ser un entero positivo, y tanto `bestRating` como `worstRating` deben especificarse para evitar ambigüedades. El comprobador de elegibilidad de fragmentos de reseña valida el marcado de valoración contra los requisitos específicos de Google para resultados enriquecidos de reseñas.
| Tipo de esquema | Resultado enriquecido | Campos obligatorios clave | Comprobador de Aback Tools |
|---|---|---|---|
| FAQPage | Acordeón de FAQ en la SERP | mainEntity con preguntas y respuestas | Generador de esquema FAQ |
| HowTo | Carrusel de pasos en la SERP | name, step, text | Generador de esquema HowTo |
| BreadcrumbList | Migas de pan en la SERP | itemListElement, name, item | Generador de esquema Breadcrumb |
| Product | Panel de producto con precio/valoración | name, offers o review | Comprobador de completitud de esquema Product |
| Article | Top Stories, Discover | headline, author, datePublished | Validador JSON-LD |
| Organization | Panel de conocimiento | name, url, logo | Validador de esquema Organization |
| LocalBusiness | Pack local, mapas | name, address, telephone | Validador de datos estructurados |
Datos estructurados en CI/CD
Las comprobaciones manuales de datos estructurados sirven para páginas individuales, pero los sitios grandes con plantillas que generan datos estructurados programáticamente necesitan validación automatizada. Añadir una comprobación de datos estructurados a tu pipeline de CI/CD detecta regresiones antes de que lleguen a producción y bloqueen la elegibilidad de resultados enriquecidos.
Extracción y validación en los pipelines de build
El enfoque más fiable es extraer el JSON-LD de tu HTML compilado y validarlo programáticamente. Tras un build, analiza los archivos HTML generados, extrae cada bloque `<script type="application/ld+json">` y pásalo por una biblioteca de validación schema.org como `schema-dts` (TypeScript), `jsonld` (Node.js) o el Structured Data Linter de Google. Haz fallar el build si falta alguna propiedad obligatoria o el JSON está mal formado.
# Extract all JSON-LD blocks from built HTML using grep
grep -rl 'application/ld+json' ./out/ | while read file; do
# Parse and validate each block
node scripts/validate-schema.js "$file"
done
# Or use a dedicated CLI tool
npx schema-validator ./out/**/*.html --strictMonitorización de funciones SERP
Tras el despliegue, monitoriza el rendimiento de los resultados enriquecidos en Google Search Console, en la sección "Mejoras". Cada tipo de esquema que hayas implementado tiene su propio informe que muestra elementos válidos, advertencias y errores según Googlebot rastrea tus páginas. Un pico repentino de errores suele indicar un cambio de plantilla que rompió el esquema de toda una categoría de páginas. El comprobador de funciones SERP ofrece una vista complementaria: qué funciones SERP activa actualmente una URL concreta.
Tip
Buenas prácticas
Seguir estas prácticas garantiza que tus datos estructurados sean correctos, mantenibles y alineados con las directrices de Google, maximizando la elegibilidad de resultados enriquecidos sin arriesgarte a acciones manuales o fallos silenciosos del esquema.
Mantén los datos estructurados sincronizados con el contenido visible
La causa más habitual de acciones manuales de Google contra los datos estructurados es una incoherencia entre el esquema y lo que ven los usuarios. Si tu esquema `Product` muestra un precio de $29 pero la página muestra $49, Google lo trata como marcado engañoso. Usa tu CMS o sistema de plantillas para generar los datos estructurados desde la misma fuente de datos que llena el contenido visible de la página; nunca codifiques a mano valores en el esquema que se muestran dinámicamente en otro lugar.
Usa tipos específicos, no genéricos
Schema.org tiene una jerarquía de tipos profunda. Una página sobre un producto de software debería usar `SoftwareApplication`, no el genérico `Product`. Un restaurante local debería usar `Restaurant` (subtipo de `FoodEstablishment`), no el genérico `LocalBusiness`. Los tipos más específicos dan a los motores más señal sobre el contenido y pueden desbloquear formatos de presentación más ricos en los resultados.
Los datos estructurados no deben usarse para engañar a los usuarios ni proporcionar información engañosa. Los datos estructurados de una página deben representar con exactitud el contenido de la página.
- Valida antes de desplegar: ejecuta el validador de datos estructurados en cada bloque de esquema antes de publicarlo; detecta los errores antes que Googlebot.
- Una entidad por bloque: anida las entidades relacionadas (por ejemplo, `author` dentro de `Article`) en lugar de crear bloques de nivel superior separados para cada subentidad.
- Usa URLs absolutas en todas partes: los campos `url`, `image`, `logo` y `sameAs` exigen URLs completas `https://`; las rutas relativas no son válidas en los datos estructurados.
- Incluye sameAs para organizaciones: enlaza tu esquema Organization con Wikipedia, Wikidata, LinkedIn y otras fuentes autoritativas para reforzar la asociación con el grafo de conocimiento.
- Monitoriza Google Search Console: revisa los informes de Mejoras semanalmente; muestran qué páginas tienen datos estructurados válidos, con advertencias o con errores a medida que Googlebot las rastrea.
Note
Key takeaways
- Comprueba si hay datos estructurados buscando `application/ld+json` en el código fuente de la página: cada etiqueta script con ese tipo es un bloque de datos estructurados.
- Usa el validador de datos estructurados durante el desarrollo para una validación JSON-LD instantánea y local en el navegador, sin enviar ninguna URL.
- La Prueba de Resultados Enriquecidos de Google es la herramienta autoritativa para la elegibilidad: ejecútala cuando la validación local esté limpia, no en su lugar.
- Los errores más comunes son propiedades obligatorias ausentes, tipos de valor incorrectos (cadenas donde se esperan números) y URLs relativas donde se exigen URLs absolutas HTTPS.
- Genera marcado de esquema correcto para los tipos FAQPage, HowTo, BreadcrumbList y Product con los generadores y validadores dedicados de Aback Tools.
- Los datos estructurados deben coincidir con el contenido visible de la página: las incoherencias entre valores del esquema y valores mostrados arriesgan acciones manuales de Google contra la elegibilidad.
- Monitoriza la sección Mejoras de Google Search Console tras el despliegue para seguir elementos válidos, advertencias y errores mientras Googlebot rastrea tus páginas.