Background Decoration
17.8.2026Dietrich Bojko15 Min. Lesezeit

SEO-Masterclass & Schema-Validierung

Zurück zur Übersicht
SEO-Masterclass & Schema-Validierung
Bild mit KI generiert.
Bild mit KI generiert.
0 Views

Häufig gestellte Fragen (FAQ)

Weil viele Suchmaschinen-Crawler und vor allem Social-Media-Bots (wie die Vorschau-Crawler von WhatsApp, Slack oder LinkedIn) JavaScript nicht oder nur unzuverlässig ausführen. Wenn die Meta-Tags erst im Browser gerendert werden, sehen diese Bots oft nur eine leere Seite ohne Titel und Bild. Durch die serverseitige generateMetadata-API im Next.js App Router stellen wir sicher, dass alle SEO-relevanten Tags bereits im initialen HTML-Dokument verankert sind.

Microdata wird direkt in den HTML-Tags (als Attribute) verschachtelt, was den Code oft unübersichtlich macht und bei Headless-Architekturen – wo Inhalt und Darstellung getrennt sind – schwer zu warten ist. JSON-LD hingegen bündelt alle strukturierten Daten sauber und isoliert in einem einzigen <script>-Block. Google empfiehlt offiziell die Nutzung von JSON-LD, da es am wenigsten fehleranfällig ist und sich per Code hervorragend dynamisch generieren lässt.

In einem produktiven Headless CMS wie Contao kommen ständig neue Inhalte hinzu – seien es neue Immobilien, Fachartikel oder Portfolio-Erweiterungen. Eine statische Sitemap müsste bei jedem neuen Beitrag manuell aktualisiert und neu deployt werden. Die dynamische sitemap.ts in Next.js fragt die aktuellen URLs live aus der Contao-API ab. So garantierst du, dass Google bei jedem Crawl-Vorgang vollautomatisch die absolut aktuellste Inhaltsstruktur deiner Website erhält.

Dein nächster Schritt: Phase 4 – Semantisches SEO & Content-Struktur

Die serverseitigen Meta-Tags sind implementiert, unsere Sitemaps leiten die Crawler sicher durchs Projekt und unser JSON-LD ist dank strukturierter Validierung fehlerfrei. Doch wie sieht es mit dem eigentlichen, sichtbaren Inhalt aus?

Suchmaschinen lesen nicht nur unsichtbare Meta-Daten im <head>, sie analysieren vor allem die Semantik deines HTML-Bodys. Eine saubere, logische Content-Struktur ist entscheidend für das Ranking und die Barrierefreiheit (Accessibility) deiner Headless-Website.

In der Headless-Architektur passiert es schnell, dass Content-Blöcke aus der CMS-API als reine <div>-Wüsten im Frontend landen. Im kommenden Teil 13: Semantisches SEO & Content-Struktur räumen wir damit auf und perfektionieren unser HTML-Gerüst:

  • API-Ausgabe optimieren: Wie wir Contao 5.x so konfigurieren, dass der JSON-Payload bereits alle relevanten semantischen Informationen für das Frontend bereithält.

  • Perfekte HTML-Struktur (H1-H6): Die goldenen Regeln für eine stringente, ununterbrochene Überschriften-Hierarchie und warum es strikt nur eine einzige H1-Überschrift pro Seite geben darf.

  • HTML5 Landmarks: Die korrekte Implementierung von <main>, <article>, <aside> und <nav>, um Crawlern den Kontext der Inhaltsblöcke verständlich zu machen.

  • Qualitätssicherung mit dem Semantic-SEO Tool: Wir nutzen den dedizierten Semantic-SEO Checker (webinteger.dev/tools/semantic-seo), um unser Next.js-Frontend automatisiert auf logische Brüche, fehlende Attribute und optimale Lesbarkeit für Suchmaschinen zu überprüfen.

Jetzt starten: Teil 13 – Semantisches SEO & Content-Struktur im Headless CMS

Dietrich Bojko
Über den Autor

Dietrich Bojko

Senior Webentwickler

Webinteger arbeitet seit vielen Jahren produktiv mit Linux-basierten Entwicklungsumgebungen unter Windows.
Der Fokus liegt auf performanten Setups mit WSL 2, Docker, PHP, Node.js und modernen Build-Tools in realen Projekten – nicht auf theoretischen Beispielkonfigurationen.

Die Artikel dieser Serie entstehen direkt aus dem täglichen Einsatz in Kunden- und Eigenprojekten und dokumentieren bewusst auch typische Fehler, Engpässe und bewährte Workarounds.

Webseite besuchen

Das könnte Sie auch interessieren

Schreiben Sie einen Kommentar