Communitygithub.com

astudio · Schema-Markup

Strukturierte Daten nach Schema.org (JSON-LD) für relevante Rich Results bis 2026 schreiben, validieren und veraltete Typen kennzeichnen.

Was ist astudio · Schema-Markup?

Diese Skill-Anleitung für KI-Agenten wie Claude Code oder Cursor automatisiert die Erstellung und Prüfung von Schema.org-Markup (JSON-LD). Sie deckt alle noch relevanten Typen für Google Rich Results im Jahr 2026 ab – darunter Organization, LocalBusiness, Product mit Offer und AggregateRating, Article, BreadcrumbList, VideoObject, Event, JobPosting, Course und QAPage. Der Skill enthält ein Lint-Skript (`schema_lint.py`), prüft gegen den Google Rich Results Test und den Yandex-Microdata-Validator, und warnt vor inzwischen wirkungslosen Typen wie FAQPage, HowTo und dem 2025er Batch. Entwickler können pro Seitentyp (Startseite, Produkt, Artikel, Kontakt, Video, Veranstaltung, Stellenanzeige, Kurs, Q&A-Forum) die passenden Typen auswählen, aus derselben Datenquelle wie die sichtbare Seite befüllen und die Regeln für Preise, Daten und Organisations-@IDs einhalten. Das Besondere: Der Skill zwingt dazu, nur das auszuzeichnen, was auch wirklich auf der Seite steht – versteckte Bewertungen oder abweichende Preise sind tabu.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht astudio · Schema-Markup?

<root> = zwei Ebenen über dem Basisverzeichnis dieses Skills. Lint: <root>/scripts/schema_lint.py. Status der Typen: <root>/reference/facts.md § Rich-Results-Status.

Strukturierte Daten sind für KI-Antworten nicht erforderlich (laut Google), aber sie geben Fakten eindeutig wieder: wer Sie sind, was das Produkt kostet, wo Sie sind, wer den Artikel geschrieben hat. Das hilft bei Rich Results, Knowledge Panels und jedem Konsumenten, der JSON-LD liest. Es hilft nur, wenn es mit dem übereinstimmt, was die Seite zeigt.

Arbeitsablauf

  1. Seitenvorlagen inventarisieren (Startseite, Kategorie, Produkt, Artikel, Kontakte, Veranstaltungen, Stellenanzeigen).
  2. Bestehendes Markup prüfen: schema_lint.py <url> pro Vorlage.
  3. Typen pro Vorlage auswählen (Tabelle unten). Ein @graph pro Seite; Entitäten stabile @id-Werte geben (https://site.ru/#organization) und referenzieren statt wiederholen.
  4. JSON-LD aus derselben Datenquelle wie die Seite schreiben (CMS-Felder), niemals durch manuelles Kopieren von Zahlen.
  5. Validieren: schema_lint.py, dann Google Rich Results Test und Schema Markup Validator, sowie für Russland den Yandex.Webmaster-Microdata-Validator. Ergebnisse in den Bericht einfügen.
  6. Diff zeigen; nach Freigabe deployen.

Typen nach Vorlage

VorlageTypenMuss mit der Seite übereinstimmen
StartseiteOrganization (oder LocalBusiness-Untertyp), WebSiteName, Logo, Kontakte; sameAs zu offiziellen Profilen (VK, Telegram, Яндекс Карты, 2ГИС, Wikipedia)
ProduktProduct + Offer (+ AggregateRating, Review falls angezeigt)Preis, Währung RUB, Verfügbarkeit, Bewertungswert und -anzahl
KategorieBreadcrumbList, ItemList (optional)Breadcrumb-Text
Artikel / BlogArticle/BlogPosting + Person (Autor)Überschrift, Autorenname mit Profilseite, Daten
Kontakte / FilialeLocalBusiness-Untertyp mit address, geo, openingHoursSpecification, telephonedieselbe NAP wie in Karten und Verzeichnissen
Video-SeiteVideoObjectVorschaubild, Upload-Datum, Dauer
Veranstaltungen / Kurse / StellenEvent, Course, JobPostingDaten, Preis, Ort, Gehalt
Q&A-Forum-SeiteQAPageechte Benutzerfragen und -antworten

Ausgemusterte oder wirkungslose Typen (nicht als Gewinn verkaufen)

FAQPage (kein Google Rich Result mehr seit 2026-05-07), HowTo (2023), ClaimReview, EstimatedSalary, Learning Video, SpecialAnnouncement, Vehicle Listing, Book Actions (2025-06-12). FAQPage/HowTo nur behalten, wenn sie sichtbaren Inhalt spiegeln und jemand anderes sie konsumiert; darauf hinweisen, dass es keinen Google-SERP-Effekt gibt.

Regeln

  • Nur das auszeichnen, was Benutzer sehen können. Versteckte Bewertungen, selbstlobende Kritiken der eigenen Organisation und vom Seitentext abweichende Preise verstoßen gegen die Google-Richtlinien und können zu manuellen Maßnahmen führen.
  • Preise: Zahl ohne Leerzeichen in price („4990“), priceCurrency: "RUB"; denselben Preis im HTML anzeigen.
  • Daten im ISO-8601-Format mit Zeitzone (2026-11-06T10:00:00+03:00).
  • Eine Organisationsentität pro Website, referenziert über @id.

Beispiel: 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"]}]}

Verwandte Skills