Configuración de cookies

Las cookies necesarias mantienen el sitio funcionando. La analítica muestra qué páginas son útiles. Puedes cambiar tu elección en cualquier momento desde el pie de página.

Política de cookies de este sitio — todos los detalles: categorías de cookies, cómo guardamos tu elección en el navegador y cómo retirar el consentimiento.

Necesarias

Funciones básicas del sitio y tu elección de consentimiento. Siempre activas.

Analítica

Ayuda a entender cómo se usa el sitio. Se carga solo si lo permites.

GitHubDescargar ZIP

Validador de datos estructurados y de schema

Valida JSON-LD, Microdata y RDFa con el vocabulario de Schema.org incluido y con las reglas locales de resultados enriquecidos de Google, y redacta JSON-LD nuevo con schema-build.

Ver en GitHubInicio rápido

Qué hace

  • App de escritorio de SpiderHead: la pestaña Schema de la URL, que informa de los bloques JSON-LD detectados y analizados.
  • SpiderHead en la terminal: seohead schema-check

Dos capas de validación

La primera capa comprueba si el marcado es Schema.org válido: que el tipo exista, que la propiedad esté permitida en él, que se tengan en cuenta las propiedades heredadas y que el valor encaje con el tipo esperado. La segunda capa comprueba las condiciones visibles en local para los resultados enriquecidos de Google, como las propiedades obligatorias. Superar la segunda capa no garantiza que Google muestre un resultado enriquecido.

  • Vocabulario de Schema.org incluido: funciona sin conexión.
  • Propiedades heredadas tratadas: un author en un Article no genera un error falso.
  • Propiedades obligatorias y propiedades de «una de las siguientes» para los tipos de resultados enriquecidos.
  • Errores de análisis cuando un bloque JSON-LD no es JSON válido.

El marcado como grafo

Las entidades se conectan mediante referencias @id. El comprobador indica qué entidades tienen un @id, cuáles están enlazadas, cuáles aparecen aisladas y si alguna referencia apunta a ninguna parte. Una entidad aislada es un hallazgo útil, porque los buscadores no pueden conectarla con el resto de la página.

  • Entidades sin @id o sin enlace con el resto
  • Referencias a un @id que no existe
  • Marcado leído de JSON-LD, Microdata y RDFa

Redactar

schema-build redacta un @graph conectado para el tipo de página, usando solo datos visibles en ella. Muestra las señales que ha usado y lo seguro que está del tipo. Tú fijas el tipo con --type cuando la suposición es débil, y revisas el borrador antes de publicarlo.

  • Datos tomados solo de la página
  • Suposición de tipo con señales y nivel de confianza
  • --type para cambiarlo
  • Se enumeran los campos recomendados que faltan

Tres pasos, un análisis guardado

  1. Valida con el vocabulario de Schema.org

    schema-check lee los datos estructurados de la página y comprueba cada tipo y cada propiedad con el vocabulario de Schema.org incluido.

  2. Comprueba el marcado como grafo

    Indica qué entidades tienen un @id, cuáles están enlazadas, cuáles aparecen aisladas y si alguna referencia @id apunta a ninguna parte.

  3. Crea el marcado que falta

    schema-build propone un @graph conectado usando solo datos visibles en la página, y enumera los campos recomendados que siguen faltando.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
SCHEMA_VALIDATION_ERRORLos datos estructurados de la página tienen errores de validación frente al vocabulario de Schema.orgImportantNúmero de errores de validación por página
STRUCTURED_DATA_PARSE_ERRORUn bloque JSON-LD existe, pero no se analiza como JSON válido, así que los buscadores lo ignoranImportantBloques encontrados frente a bloques analizados
STRUCTURED_DATA_MISSINGLa página no tiene marcado de Schema.orgTipPágina con cero bloques de datos estructurados
También en el registro de comprobaciones
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSING

Un solo comando

bash
seohead schema-check --url https://example.com/product

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • La URL de una página, o el propio HTML (argumento html) para una comprobación sin conexión
  • Un nombre de tipo para schema-build cuando la suposición sea débil
  • Sin claves de API

Límites

  • Una comprobación estática no puede saber si Google mostrará de verdad un resultado enriquecido.
  • Solo ve el HTML que recibe: el marcado inyectado por JavaScript no se detecta, a menos que el HTML se renderice antes.
  • RDFa, el HTML y el tamaño del grafo tienen límites; si se alcanza uno, el resultado es parcial y se indica de forma explícita.
  • schema-build redacta marcado, pero no lo publica.

Preguntas

¿Qué ejecuto?
seohead schema-check --url https://example.com/product. Para comprobar el marcado sin conexión, pasa el propio HTML en el argumento html, por ejemplo con --input y un objeto JSON.
¿La herramienta comprueba también la elegibilidad para resultados enriquecidos?
Sí, en local. La primera capa es el vocabulario de Schema.org: si un tipo existe, si una propiedad está permitida en él y si el tipo del valor encaja. La segunda capa comprueba las propiedades obligatorias de cada tipo de resultado enriquecido de Google para el que tiene reglas. No puede saber si Google mostrará el resultado.
¿Qué formatos de marcado lee?
JSON-LD, Microdata y RDFa. Un bloque JSON-LD que no se puede analizar se informa como error de análisis, porque los buscadores lo ignoran.
¿schema-build inventará datos para mi página?
No. Construye el grafo a partir de datos visibles en la página, y muestra las señales y su confianza. Si la suposición de tipo tiene baja confianza, fija el tipo tú mismo con --type.
¿Cambia mi sitio?
No. Ambos comandos solo leen la página. El JSON-LD que redacta es una sugerencia que tú revisas y despliegas por tu cuenta.
¿También funciona dentro de un rastreo?
Sí. Un rastreo registra hallazgos de datos estructurados por página: marcado ausente, errores de análisis, errores de schema y propiedades obligatorias de resultados enriquecidos que faltan.

Sigue explorando

Del blog y el glosario

Schema.org JSON-LD: datos estructurados para Google SearchBlogSchema.orgGlosarioJSON-LD: datos estructurados expresados como JSON enlazadoGlosarioDatos estructuradosGlosario

Más de este grupo · Auditoría

Auditoría técnica de SEOFunciónComprobador de redirecciones: cadenas, bucles y 302FunciónComprobador de enlaces rotos con origen y posiciónFunciónComprobador de etiquetas canonicalFunciónComprobador de hreflangFunciónComprobador de títulos y meta descripcionesFunciónComprobador de estructura de encabezadosFunciónComprobador de contenido duplicado y pobreFunciónComprobador y optimizador de SEO de imágenesFunciónAuditoría de enlazado interno y profundidad de clicsFunciónComprobaciones de peso y velocidad de la páginaFunciónComprobación de HTTPS y cabeceras de seguridadFunciónVisibilidad en la búsqueda con IA (GEO/AEO)Función

Pruébalo en tu propio sitio

Descargar ZIPTodas las funciones