Cómo comprobar los datos estructurados JSON-LD de una página web
Comprueba si el JSON-LD de cualquier página web tiene errores o campos que faltan, consulta cada elemento de schema.org que describe y lee el JSON de cada bloque.
3 min de lectura
Para comprobar el JSON-LD de una página web, abre el Validador de JSON-LD, pega la dirección de la página y haz clic en "Obtener y validar JSON-LD". El resultado muestra todos los problemas, cada elemento que describe la página y el JSON de cada bloque. Si la página no tiene problemas, el resumen aparece en verde.
Cómo comprobar una página
- Abre la página en el navegador y copia la dirección de la barra de direcciones.
- Pégala en el campo URL. Si la dirección no incluye
https://, se añadirá automáticamente. - Haz clic en "Obtener y validar JSON-LD".
- Lee el resumen que aparece encima de las tablas. Indica el número de bloques, errores y advertencias.
- Elige un bloque en «Origen» para ver su JSON con números de línea.
Cómo leer el resultado
- La tabla de problemas muestra cada error y advertencia. Solo aparece si hay algún problema.
- «Bloque» indica el número del bloque de script, contado desde la parte superior de la página.
- «Ubicación» muestra dónde está el problema, por ejemplo,
Product.image. - La tabla de elementos muestra cada elemento, su tipo, como Article o Product, y su nombre.
- Haz clic en el encabezado de una columna para ordenar la tabla. Los botones debajo de cada tabla permiten exportarla como CSV o JSON.
Qué problemas corregir primero
Los errores aparecen primero en la lista y tienen una etiqueta roja. Las advertencias tienen una etiqueta amarilla. Un error significa que algo está roto o que falta un campo obligatorio. Las advertencias marcadas como «(opcional)» corresponden a campos que puedes añadir si tienes los datos.
Estos mensajes tienen soluciones sencillas.
| Mensaje | Solución |
|---|---|
| JSON no válido | Comprueba si falta una coma o una comilla, o si hay una coma después del último valor. |
Falta @context; añade "@context": "https://schema.org" |
Añade esta línea al bloque. |
| Falta @type | Añade un tipo, como "@type": "Product". |
| "@Type" no es una palabra clave de JSON-LD | Escribe las palabras clave en minúsculas: @type. |
| El tipo "Organisation" no es un tipo válido de schema.org | Usa el nombre exacto de schema.org; en este caso, Organization. |
| Falta el atributo obligatorio "image" | Añade el campo que indica el mensaje. |
Cuando la comprobación no encuentra nada o falla
«No se encontraron bloques de script JSON-LD en esta página» significa que el HTML de la página no contiene JSON-LD. La comprobación lee la página tal como la envía el servidor. No detecta el JSON-LD que un script añade después en el navegador.
«No se pudo obtener la página» significa que el sitio no envió la página. También ocurre cuando la dirección redirige a otra, porque no se siguen las redirecciones. Copia la dirección final de la barra de direcciones y vuelve a intentarlo.
Solo se comprueban los primeros 3 MB de una página. Si la página es más grande, aparecerá un mensaje.
Corrige los errores, actualiza la página y vuelve a ejecutar la comprobación.
¿Quieres probar la herramienta?
Validador de JSON-LD
Introduce una URL y el servidor obtiene la página, extrae cada bloque de datos estructurados JSON-LD y comprueba si contiene errores de sintaxis JSON, ausencia de @context y @type, tipos y propiedades de schema.org desconocidos, y los campos que Google necesita para los resultados enriquecidos.