Skip to content

/structured-data

Generar datos estructurados JSON-LD validados contra schema.org. Activar ante: JSON-LD, schema.org, rich snippets, datos estructurados, marcado semantico

From plugin
11262 skills19 agents25 commands7 hooks1 MCP
shell
$ npx -y skills add 686f6c61/alfred-dev --skill structured-data --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/structured-data
How auto-invocation works

Context preview

The summary Claude sees to decide when to auto-load this skill.

Generar datos estructurados JSON-LD validados contra schema.org. Activar ante: JSON-LD, schema.org, rich snippets, datos estructurados, marcado semantico

SKILL.md

structured-data.SKILL.md
name: structured-data
description: "Generar datos estructurados JSON-LD validados contra schema.org. Activar ante: JSON-LD, schema.org, rich snippets, datos estructurados, marcado semantico"

Generar datos estructurados JSON-LD

Resumen

Este skill genera datos estructurados en formato JSON-LD basados en el vocabulario de schema.org. Los datos estructurados permiten a los buscadores entender el contenido de una pagina de forma semantica, lo que puede resultar en rich snippets (resultados enriquecidos) que mejoran la visibilidad y el CTR en las paginas de resultados.

El formato JSON-LD es el recomendado por Google porque se inserta como un bloque `<script>` independiente en el `<head>`, sin modificar el HTML visible. Esto lo hace mas facil de mantener y menos propenso a errores que los formatos alternativos (Microdata, RDFa).

Proceso

1. **Identificar los tipos de schema aplicables.** Analizar cada pagina del sitio para determinar que tipos de datos estructurados son relevantes. Los tipos mas comunes son:

  • **Organization**: pagina principal o "Acerca de". Campos obligatorios: `name`, `url`, `logo`. Recomendados: `sameAs` (perfiles sociales), `contactPoint`, `address`.
  • **WebSite**: pagina principal. Campos obligatorios: `name`, `url`. Recomendados: `potentialAction` con SearchAction si hay buscador interno.
  • **Article / BlogPosting**: paginas de blog o noticias. Campos obligatorios: `headline`, `author`, `datePublished`, `image`. Recomendados: `dateModified`, `publisher`, `description`.
  • **Product**: paginas de producto. Campos obligatorios: `name`, `image`, `offers` (con `price`, `priceCurrency`, `availability`). Recomendados: `brand`, `sku`, `aggregateRating`.
  • **FAQPage**: paginas con preguntas frecuentes. Campos obligatorios: `mainEntity` con array de `Question`, cada una con `acceptedAnswer`.
  • **BreadcrumbList**: todas las paginas con navegacion de migas de pan. Campos obligatorios: `itemListElement` con `position`, `name` e `item` (URL).

2. **Generar el markup JSON-LD para cada pagina.** Crear el bloque `<script type="application/ld+json">` correspondiente. Ejemplo para Organization:

   {
     "@context": "https://schema.org",
     "@type": "Organization",
     "name": "Nombre de la empresa",
     "url": "https://ejemplo.com",
     "logo": "https://ejemplo.com/logo.png",
     "sameAs": [
       "https://twitter.com/ejemplo",
       "https://linkedin.com/company/ejemplo"
     ]
   }

3. **Combinar tipos cuando corresponda.** Una pagina puede tener multiples bloques JSON-LD. Por ejemplo, la pagina principal puede incluir Organization, WebSite y BreadcrumbList simultaneamente. Cada uno va en su propio bloque `<script>` o se combinan en un array con `@graph`.

4. **Validar el markup.** Antes de publicar, verificar cada bloque contra:

  • **Schema Markup Validator** (validator.schema.org): comprueba la sintaxis y el vocabulario.
  • **Rich Results Test** (search.google.com/test/rich-results): comprueba si Google puede generar resultados enriquecidos a partir del markup.

Corregir cualquier error o advertencia antes de desplegar.

5. **Insertar en el HTML.** Colocar los bloques JSON-LD dentro del `<head>` de cada pagina. Si se usa un framework o CMS, verificar que no genera duplicados.

Que NO hacer

  • No inventar datos que no existen en la pagina: el markup debe reflejar el contenido visible.
  • No usar tipos de schema incorrectos (por ejemplo, marcar un articulo como Product).
  • No omitir campos obligatorios, ya que el markup no generara rich snippets sin ellos.
  • No asumir que el markup es correcto sin validarlo: un JSON mal formado se ignora silenciosamente.
Read more
Read it on GitHub ↗
Ships withalfred-dev

Plugin de Claude Code: 18 agentes especializados, 60 skills, 25 comandos, 13 hooks, memoria persistente, Memory UI local, quality gates, evidence guard, continuidad operativa y modo autopilot.

Get the whole plugin, auto-invoked
Stats
112
Stars
0
Views
8
Forks
Active
Maintenance
Python
Language
8d ago
Last commit
5mo ago
Created

Repo: 686f6c61/alfred-dev

Other skills on alfred-dev.