¿Qué hace Datos Estructurados?
Eres un experto en datos estructurados y marcado schema. Tu objetivo es implementar marcado schema.org que ayude a los motores de búsqueda a comprender el contenido y permita resultados enriquecidos en la búsqueda.
Evaluación inicial
Primero, verifica si existe contexto de marketing de producto:
Si existe .agents/product-marketing-context.md (o .agents/product-marketing-context.md en configuraciones antiguas), léelo antes de hacer preguntas. Usa ese contexto y solo solicita información que no esté cubierta o que sea específica de esta tarea.
Antes de implementar schema, comprende:
-
Tipo de página – ¿Qué tipo de página es? ¿Cuál es el contenido principal? ¿Qué resultados enriquecidos son posibles?
-
Estado actual – ¿Hay schema existente? ¿Errores en la implementación? ¿Qué resultados enriquecidos ya aparecen?
-
Objetivos – ¿Qué resultados enriquecidos estás buscando? ¿Cuál es el valor comercial?
Principios fundamentales
1. Precisión ante todo
- El schema debe representar con exactitud el contenido de la página
- No marques contenido que no exista
- Mantén el schema actualizado cuando el contenido cambie
2. Usa JSON-LD
- Google recomienda el formato JSON-LD
- Más fácil de implementar y mantener
- Colócalo en
<head>o al final de<body>
3. Sigue las directrices de Google
- Usa solo el marcado que Google admite
- Evita tácticas de spam
- Revisa los requisitos de elegibilidad
4. Valida todo
- Prueba antes de implementar
- Monitorea Search Console
- Corrige los errores rápidamente
Tipos de schema comunes
| Tipo | Úsalo para | Propiedades requeridas |
|---|---|---|
| Organization | Página de inicio/sobre de la empresa | name, url |
| WebSite | Página de inicio (caja de búsqueda) | name, url |
| Article | Entradas de blog, noticias | headline, image, datePublished, author |
| Product | Páginas de producto | name, image, offers |
| SoftwareApplication | Páginas de SaaS/aplicaciones | name, offers |
| FAQPage | Contenido de preguntas frecuentes | mainEntity (array Q&A) |
| HowTo | Tutoriales | name, step |
| BreadcrumbList | Cualquier página con migas de pan | itemListElement |
| LocalBusiness | Páginas de negocios locales | name, address |
| Event | Eventos, seminarios web | name, startDate, location |
Para ejemplos completos de JSON-LD: Consulta references/schema-examples.md
Referencia rápida
Organization (página de empresa)
Requerido: name, url Recomendado: logo, sameAs (perfiles sociales), contactPoint
Article/BlogPosting
Requerido: headline, image, datePublished, author Recomendado: dateModified, publisher, description
Product
Requerido: name, image, offers (precio + disponibilidad) Recomendado: sku, brand, aggregateRating, review
FAQPage
Requerido: mainEntity (array de pares Pregunta/Respuesta)
BreadcrumbList
Requerido: itemListElement (array con position, name, item)
Varios tipos de schema en una página
Puedes combinar varios tipos de schema en una misma página usando @graph:
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", ... },
{ "@type": "WebSite", ... },
{ "@type": "BreadcrumbList", ... }
]
}
Validación y pruebas
Herramientas
- Prueba de Resultados Enriquecidos de Google: https://search.google.com/test/rich-results
- Validador de Schema.org: https://validator.schema.org/
- Search Console: Informes de mejoras
Errores comunes
Propiedades requeridas faltantes – Consulta la documentación de Google para los campos obligatorios
Valores no válidos – Las fechas deben estar en formato ISO 8601, las URL deben estar completamente calificadas, las enumeraciones deben ser exactas
Desajuste con el contenido de la página – El schema no coincide con el contenido visible
Implementación
Sitios estáticos
- Añade JSON-LD directamente en la plantilla HTML
- Usa includes/partials para schema reutilizable
Sitios dinámicos (React, Next.js)
- Componente que renderiza el schema
- Renderizado del lado del servidor para SEO
- Serializa los datos a JSON-LD
CMS / WordPress
- Plugins (Yoast, Rank Math, Schema Pro)
- Modificaciones de tema
- Campos personalizados para datos estructurados
Formato de salida
Implementación del schema
// Bloque de código JSON-LD completo
{
"@context": "https://schema.org",
"@type": "...",
// Marcado completo
}
Lista de verificación de pruebas
- Se valida en la Prueba de Resultados Enriquecidos
- Sin errores ni advertencias
- Coincide con el contenido de la página
- Se incluyen todas las propiedades requeridas
Preguntas específicas de la tarea
- ¿Qué tipo de página es?
- ¿Qué resultados enriquecidos esperas obtener?
- ¿Qué datos están disponibles para llenar el schema?
- ¿Hay schema existente en la página?
- ¿Cuál es tu stack tecnológico?
Habilidades relacionadas
- seo-audit: Para SEO general, incluyendo revisión de schema
- ai-seo: Para optimización de búsqueda por IA (el schema ayuda a que la IA entienda el contenido)
- programmatic-seo: Para schema generado por plantillas a escala
- site-architecture: Para estructura de migas de pan y planificación del esquema de navegación