# Datos estructurados en SEO: qué son y ejemplo

> Lee un ejemplo JSON-LD de artículo y separa la sintaxis válida, los requisitos de Google y la aparición de resultados enriquecidos.


**Los datos estructurados en SEO son información con un formato definido que describe el contenido de una página para los buscadores.** Pueden identificar un artículo, su título o su autor mediante propiedades reconocibles. Complementan el contenido visible y pueden permitir ciertas presentaciones en Google cuando se cumplen los requisitos de una función.

Conviene separar tres preguntas: ¿el código tiene una sintaxis válida?, ¿el marcado cumple los requisitos pertinentes?, ¿Google lo muestra con una presentación especial? Una respuesta afirmativa a la primera no resuelve las otras dos.

## Ejemplo de datos estructurados para un artículo

Imagina un blog ficticio llamado Taller del Barrio que publica un artículo sobre mantenimiento de bicicletas. Este fragmento JSON-LD describe solo algunos datos básicos; no es una implementación completa ni demuestra elegibilidad para una función específica:

```json
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Cómo preparar una bicicleta para un viaje",
"author": {
"@type": "Organization",
"name": "Taller del Barrio"
},
"url": "https://www.example.com/blog/preparar-bicicleta/"
}
```

`@context` identifica el vocabulario y `@type` declara el tipo de contenido. `headline` contiene el título, `author` identifica al autor y `url` señala la página. El dominio, el editor y el artículo son ilustrativos. En HTML, este JSON se incorpora normalmente en un elemento `script` con tipo `application/ld+json`.

La [introducción de Google a datos estructurados](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data) explica los formatos admitidos. El vocabulario permite describir muchas cosas, pero Google solo ofrece funciones específicas para determinados tipos y condiciones.

## El contenido visible debe sostener el marcado

Si el artículo real tiene otro título o autor, copia los datos reales. Añadir una fecha de actualización exige que corresponda al trabajo realizado; cambiarla automáticamente cada día produciría una señal engañosa. Tampoco inventes valoraciones, testimonios ni credenciales para conseguir una apariencia de autoridad.

Antes de elegir propiedades, lee los requisitos de la función concreta en la documentación vigente. Un plugin puede generar JSON correcto y aun así describir el tipo de página equivocado. También puede duplicar un marcado que el tema ya emite. Revisa el HTML final para entender qué está recibiendo el buscador.

## Cómo validar sin prometer resultados

| Comprobación | Lo que permite concluir |
|---|---|
| El JSON se puede analizar | La sintaxis de ese bloque es válida |
| La herramienta reconoce el tipo y sus propiedades | El bloque tiene una estructura interpretable |
| Rich Results Test identifica una función compatible | La herramienta puede evaluar requisitos de esa función |
| La página pública está accesible y sus datos son fieles | La implementación entregada coincide con el contenido |
| Se observa un resultado enriquecido en una búsqueda | Esa presentación apareció en ese contexto y momento |

Las [políticas de Google](https://developers.google.com/search/docs/appearance/structured-data/sd-policies) exigen calidad y acceso además de condiciones técnicas. Google no garantiza mostrar resultados enriquecidos aun cuando el marcado sea correcto. Una herramienta puede no detectar ningún tipo compatible en un bloque válido que usa un vocabulario sin función de búsqueda asociada.

Para revisar el vocabulario y las propiedades, usa el [validador de Schema.org](https://validator.schema.org/). Para evaluar funciones compatibles con Google, usa [Rich Results Test](https://search.google.com/test/rich-results). Si describes un artículo, consulta sus [propiedades recomendadas por Google](https://developers.google.com/search/docs/appearance/structured-data/article) y contrástalas con los datos reales de la página.

## Qué pedir al responsable de la web

Entrega la URL, el tipo de página, los datos visibles que deben describirse y la función que quieres evaluar. Pide una validación del HTML publicado y un registro de errores resueltos. Si el problema es que Google todavía no conoce la página, revisa primero [rastreo e indexación](/es/guides/rastreo-indexacion/). Añadir un bloque de datos no resuelve por sí solo una página bloqueada o una respuesta vacía.

## Planifica el próximo post en HeyMark.

Guarda la idea, revisa el texto con tu equipo y mira cómo le fue después en las cuentas que conectaste.

[Empezar gratis](https://app.heymark.ai) · [Ver cómo funciona](https://heymark.ai/es/#product)

## Recursos para desarrolladores y agentes

- [Documentación MCP de HeyMark](https://heymark.ai/es/mcp/)
- [llms.txt](https://heymark.ai/llms.txt)
- [Contenido completo del sitio para modelos de lenguaje](https://heymark.ai/llms-full.txt)
- Endpoint del protocolo MCP: `POST https://mcp.heymark.ai`
- Metadatos OAuth del recurso protegido: [/.well-known/oauth-protected-resource](https://mcp.heymark.ai/.well-known/oauth-protected-resource)
- MCP server card: [/server-card](https://mcp.heymark.ai/server-card)
