Communitygithub.com

astudio · Marcado Schema.org

Elige tipos de datos estructurados Schema.org (JSON-LD) que aún importan en 2026 (Organization, LocalBusiness, Product + Offer + AggregateRating, Article, BreadcrumbList, VideoObject, Event, JobPosting, Course, QAPage), escríbelos para que coincidan con la página visible, verifica su sintaxis y marca los resultados enriquecidos retirados (FAQPage, HowTo y el lote de 2025). Cubre Google Rich Results Test y el validador de microdatos de Yandex. Útil para 'микроразметка', 'schema.org', 'JSON-LD', 'rich snippets', 'расширенные сниппеты', 'разметка товара', 'разметка организации'. Parte de astudio-ai-seo.

¿Qué es astudio · Marcado Schema.org?

Esta habilidad para agentes de IA (compatible con Claude Code, Cursor, Codex y otras herramientas similares) te guía en la implementación de datos estructurados Schema.org en formato JSON-LD, centrándose en los tipos que Google aún considera relevantes a partir de 2026 (como Organization, LocalBusiness, Product con Offer y AggregateRating, Article, BreadcrumbList, VideoObject, Event, JobPosting, Course y QAPage). Su utilidad radica en que los datos estructurados, aunque no sean obligatorios para respuestas de IA, definen hechos de manera inequívoca: quién eres, qué cuesta un producto, dónde estás o quién escribió un artículo, lo que favorece los resultados enriquecidos y los paneles de conocimiento. El agente sigue un flujo de trabajo completo: inventariar plantillas de página (inicio, producto, artículo, etc.), verificar el marcado existente mediante un script linter (`schema_lint.py`), elegir los tipos adecuados para cada plantilla, generar el JSON-LD desde la misma fuente de datos de la página (sin copiar manualmente números) y validar con herramientas como Google Rich Results Test y el validador de microdatos de Yandex. Además, identifica los tipos que han perdido efecto en los resultados de búsqueda (como FAQPage, HowTo o los retirados en 2025) para no venderlos como beneficios. La habilidad impone reglas estrictas: marcar solo lo que el usuario ve, mantener precios y fechas en formatos correctos, y usar una única entidad de organización referenciada por @id en todo el sitio.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whoamnesia/ai-seo/tree/HEAD/skills/schema-markup

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace astudio · Marcado Schema.org?

<root> = dos niveles por encima del directorio base de esta habilidad. Verificación: <root>/scripts/schema_lint.py. Estado de los tipos: <root>/reference/facts.md § Estado de los resultados enriquecidos.

Los datos estructurados no son necesarios para las respuestas de IA (Google lo afirma), pero establecen los hechos de manera inequívoca: quién eres, cuánto cuesta el producto, dónde estás, quién escribió el artículo. Esto ayuda a los resultados enriquecidos, los paneles de conocimiento y a cualquier consumidor que lea JSON-LD. Solo ayudan cuando coinciden con lo que muestra la página.

Flujo de trabajo

  1. Inventariar las plantillas de página (inicio, categoría, producto, artículo, contactos, eventos, vacantes).
  2. Verificar lo que existe: schema_lint.py <url> por plantilla.
  3. Elegir los tipos por plantilla (tabla más abajo). Un @graph por página; asignar valores @id estables a las entidades (https://site.ru/#organization) y referenciarlas en lugar de repetirlas.
  4. Escribir el JSON-LD desde la misma fuente de datos que la página (campos del CMS), nunca copiando números manualmente.
  5. Validar: schema_lint.py, luego Google Rich Results Test y Schema Markup Validator, y para Rusia el validador de microdatos de Yandex Webmaster. Pegar los resultados en el informe.
  6. Mostrar el diff; desplegar después de una confirmación.

Tipos por plantilla

PlantillaTiposDebe coincidir con la página
InicioOrganization (o subtipo LocalBusiness), WebSitenombre, logotipo, contactos; sameAs a perfiles oficiales (VK, Telegram, Яндекс Карты, 2ГИС, Wikipedia)
ProductoProduct + Offer (+ AggregateRating, Review si se muestran)precio, moneda RUB, disponibilidad, valor y recuento de la valoración
CategoríaBreadcrumbList, ItemList (opcional)texto de la miga de pan
Artículo / blogArticle/BlogPosting + Person (autor)titular, nombre del autor con una página de perfil, fechas
Contactos / sucursalSubtipo LocalBusiness con address, geo, openingHoursSpecification, telephonela misma NAP que en mapas y directorios
Página de videoVideoObjectminiatura, fecha de subida, duración
Eventos / cursos / trabajosEvent, Course, JobPostingfechas, precio, ubicación, salario
Página de foro Q&AQAPagepreguntas y respuestas reales de usuarios

Tipos retirados o sin efecto (no los vendas como beneficios)

FAQPage (sin resultado enriquecido de Google desde 2026-05-07), HowTo (2023), ClaimReview, EstimatedSalary, Learning Video, SpecialAnnouncement, Vehicle Listing, Book Actions (2025-06-12). Conserva FAQPage/HowTo solo si reflejan contenido visible y alguien más los consume; di que no tienen efecto en SERP de Google.

Reglas

  • Marca solo lo que los usuarios pueden ver. Valoraciones ocultas, reseñas autocomplacientes de tu propia organización y precios que difieran de la página violan la política de Google y pueden conllevar una acción manual.
  • Precios: número sin espacios en price ("4990"), priceCurrency: "RUB"; muestra el mismo precio en el HTML.
  • Fechas en ISO 8601 con zona horaria (2026-11-06T10:00:00+03:00).
  • Una entidad de organización por sitio, referenciada por @id.

Ejemplo: LocalBusiness

{"@context":"https://schema.org","@graph":[{"@type":"CafeOrCoffeeShop","@id":"https://zerno.ru/#org",
"name":"Кофейня «Зерно»","url":"https://zerno.ru/","logo":"https://zerno.ru/logo.svg","telephone":"+7 843 000-00-00",
"address":{"@type":"PostalAddress","streetAddress":"ул. Баумана, 1","addressLocality":"Казань","postalCode":"420111","addressCountry":"RU"},
"geo":{"@type":"GeoCoordinates","latitude":55.7887,"longitude":49.1221},
"openingHoursSpecification":[{"@type":"OpeningHoursSpecification","dayOfWeek":["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday"],"opens":"08:00","closes":"22:00"}],
"sameAs":["https://vk.com/zerno","https://yandex.ru/maps/org/000"]}]}

Skills relacionados