GuíasPosicionamiento en IA
Tutorial: añadir datos estructurados (JSON‑LD) en Astro
1. El componente
---
// src/components/JsonLd.astro
const { data } = Astro.props;
---
<script type="application/ld+json" set:html={JSON.stringify(data)} />
set:html evita que Astro escape las comillas del JSON.
2. Una página de artículo
---
import JsonLd from '../components/JsonLd.astro';
const article = {
'@context': 'https://schema.org',
'@type': 'Article',
headline: 'Título de la guía',
datePublished: '2026-11-12',
author: { '@type': 'Organization', name: 'Tu empresa' },
};
---
<head>
<JsonLd data={article} />
</head>
3. Qué tipo, dónde
| Página | Tipo |
|---|---|
| Portada | Organization o LocalBusiness |
| Guía, artículo | Article |
| Ficha de producto | Product, con Offer |
| Todas | BreadcrumbList |
| Preguntas y respuestas | FAQPage |
4. Comprobar
- 1El código fuenteEl bloque JSON-LD está presente y es válido.
- 2La prueba de resultados enriquecidosLa herramienta de Google señala los errores.
- 3Search ConsoleEl informe de mejoras, tras la indexación.
Por qué sirve a los motores de IA: Schema.org y motores de IA.
Preguntas frecuentes
- ¿Hace falta una librería?
- No. Un objeto JavaScript y JSON.stringify bastan. Una librería de tipos puede ayudar a evitar errores en las propiedades.
- ¿Qué tipos poner primero?
- Organization (o LocalBusiness) en la portada, Article en los contenidos, Product en las fichas de producto, BreadcrumbList en todas.
- ¿Deben verse los datos en la página?
- Sí. El JSON-LD describe lo que muestra la página; anunciar otra cosa va contra las directrices de Google.