Solicita hoy tu auditoría SEO gratuita Llama al 91 060 30 90
</>Guía Técnica · 18 min de lectura

Datos estructurados y Schema.org: guía de implementación técnica

Los datos estructurados no son una técnica de posicionamiento en el sentido de que añadirlos suba tu ranking directamente; son un lenguaje estandarizado (Schema.org, mantenido conjuntamente por Google, Bing, Yahoo y Yandex) para describirle a un buscador, de forma inequívoca, qué es cada elemento de tu página: que un número es un precio y no un año, que un texto es el nombre de un autor y no un título, que una fecha es la de publicación y no la de última edición. Esa claridad es lo que permite que Google construya los llamados rich results: estrellas de valoración, precios, preguntas frecuentes desplegables o migas de pan directamente en la página de resultados.

Por qué JSON-LD y no microdatos ni RDFa

Schema.org se puede implementar con tres sintaxis distintas: microdatos y RDFa, que se entrelazan directamente con los atributos del HTML visible, y JSON-LD, que se declara como un bloque de script independiente, separado del HTML que ve el usuario. Google recomienda JSON-LD explícitamente por una razón práctica y no solo estética: al no depender de los atributos del HTML visible, se puede añadir, actualizar o eliminar sin tocar el marcado que ya funciona, y se puede generar dinámicamente desde datos de una base de datos sin riesgo de romper el diseño de la página.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Silla nórdica de roble",
  "image": "https://www.tudominio.com/img/silla-nordica.jpg",
  "offers": {
    "@type": "Offer",
    "priceCurrency": "EUR",
    "price": "189.00",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "83"
  }
}
</script>

Los tipos de dato estructurado con mayor impacto visible

No todos los tipos de Schema.org generan un rich result visible en Google; muchos son puramente semánticos y ayudan al entendimiento del contenido sin cambiar el aspecto del resultado. Entre los que sí tienen impacto visual directo destacan Product (precio, disponibilidad y valoración con estrellas), Recipe (tiempo de preparación, calorías y valoración, con imagen destacada en carrusel), FAQPage (preguntas desplegables directamente bajo el resultado, que ocupan mucho más espacio visual que un resultado normal), HowTo (pasos numerados), Article o BlogPosting (fecha, autor e imagen destacada en Google Discover) y LocalBusiness (horario, dirección y teléfono en el panel de conocimiento local).

Errores de implementación que hacen que Google ignore el marcado

El más frecuente y más grave es marcar datos que no son visibles para el usuario en la página: por ejemplo, declarar una valoración de 4.8 estrellas en el JSON-LD cuando esa valoración no aparece en ningún sitio del contenido visible. Esto viola directamente las directrices de Google sobre datos estructurados y puede derivar en una acción manual que desactiva todos los rich results del dominio, no solo del tipo afectado.

El segundo error habitual es una jerarquía de propiedades mal anidada: por ejemplo, poner price directamente en Product en vez de dentro de su propiedad offers, que es donde la especificación de Schema.org exige que viva. Este tipo de errores de estructura no siempre generan un error explícito en la validación pero sí hacen que Google descarte silenciosamente el rich result correspondiente, sin explicar por qué.

El tercer error es duplicar el mismo tipo de dato con valores distintos en la misma página, por ejemplo un bloque FAQPage generado por un plugin y otro añadido manualmente con preguntas diferentes: Google toma solo uno (normalmente el primero que procesa) o descarta ambos si detecta la contradicción.

Cómo validar el marcado antes de publicarlo

Existen dos niveles de validación con propósitos distintos. Un validador de sintaxis comprueba que el JSON-LD es JSON válido y que respeta la estructura de propiedades que exige Schema.org, pero no dice nada sobre si Google efectivamente generará un rich result con esos datos: para eso hace falta la herramienta de prueba de resultados enriquecidos de Google, que además de validar la sintaxis confirma qué tipos de rich result son elegibles según las directrices vigentes (que cambian con más frecuencia que la propia especificación de Schema.org).

// Validación básica de sintaxis JSON antes de publicar,
// desde cualquier consola con Node.js disponible
JSON.parse(document.querySelector('script[type="application/ld+json"]').textContent)

Datos estructurados y contenido generado por IA en buscadores conversacionales

Con la aparición de resúmenes generados por IA en los resultados de búsqueda (AI Overviews) y de motores de respuesta conversacional que citan fuentes, el marcado Schema.org ha ganado un segundo propósito además de los rich results tradicionales: sigue siendo la forma más directa de comunicar hechos verificables (precio, disponibilidad, autor, fecha) a sistemas que sintetizan contenido de varias fuentes, precisamente porque elimina la ambigüedad que sí existe al extraer esos mismos datos únicamente del texto en lenguaje natural.

Mantenimiento: el dato estructurado que se desactualiza es peor que no tenerlo

Un error de gestión más que de implementación: marcar un producto como InStock en el JSON-LD cuando en realidad está agotado, o dejar una valoración de estrellas fija en el marcado mientras las reseñas reales siguen acumulándose y cambiando la media. Estos desajustes entre el dato estructurado y la realidad del contenido son exactamente el tipo de señal que las directrices de calidad de Google identifican como marcado engañoso, con independencia de si fue un error de sincronización y no una intención de manipular.

Preguntas frecuentes

¿Los datos estructurados mejoran directamente el posicionamiento?

No de forma directa: no son un factor de ranking en sí mismos. Lo que hacen es habilitar formatos de resultado (rich results) que suelen mejorar la tasa de clics, lo cual indirectamente puede beneficiar el rendimiento de la página en el tiempo.

¿Puedo usar varios tipos de Schema.org en la misma página?

Sí, y es habitual: por ejemplo, combinar Product con BreadcrumbList y Organization en una misma ficha de producto, siempre que cada tipo se declare en su propio bloque JSON-LD o en un array bien formado, sin mezclar propiedades de tipos distintos en un mismo objeto.

¿Qué pasa si Google detecta datos estructurados que no coinciden con el contenido visible?

En el mejor caso, ignora silenciosamente ese bloque de datos y no muestra el rich result. En casos más graves o sistemáticos, puede aplicar una acción manual por "datos estructurados no ajustados a las directrices", visible en Search Console, que desactiva los rich results de todo el dominio hasta que se corrige.

¿Es necesario usar exactamente los nombres de propiedad de la documentación de Schema.org?

Sí, son sensibles a mayúsculas y minúsculas y no admiten sinónimos: aggregateRating no funciona si se escribe AggregateRating o rating_average. La documentación oficial de schema.org es la referencia normativa, no las directrices de Google (que documentan qué subconjunto de propiedades usa cada rich result, pero no inventan su propia sintaxis).

¿Hace falta actualizar el marcado cada vez que cambia el precio o el stock?

Sí, si el marcado se genera manualmente y de forma estática. La solución robusta es generar el JSON-LD dinámicamente a partir de los mismos datos que alimentan el precio y el stock visibles en la página, para que ambos se mantengan sincronizados automáticamente sin depender de una actualización manual paralela.

¿Hablamos de SEO técnico para tu web?

Cuéntanos tu proyecto y te decimos cómo podemos ayudarte, sin compromiso.

Llama al 91 060 30 90