FAQ Schema Generator

So erzeugst du FAQ-Schema

Schreib jedes Paar einmal; der Generator rendert beide Ausgaben aus derselben Liste, sodass Markup und sichtbare FAQ nichts Unterschiedliches sagen können.

1. Fragen und Antworten eintragen. Eine Zeile pro Paar. Formuliere die Frage so, wie sie ins Suchfeld getippt wird, und lass den ersten Satz der Antwort für sich allein eine vollständige Antwort sein.
2. Warnungen lesen. Leere Zeilen werden übersprungen, eine Zeile mit nur Frage oder nur Antwort ist ein Fehler, doppelte Fragen und sehr lange Antworten werden markiert.
3. JSON-LD einfügen. Kopiere den Skriptblock in die Seite — head oder body, beides funktioniert — ein FAQPage-Block pro Seite.
4. Sichtbares HTML einfügen. Kopiere den details/summary-Block dorthin, wo Leser die FAQ sehen sollen. Er enthält exakt den Text, den das JSON-LD deklariert. Wenn du später eines von beiden änderst, erzeuge beide neu.

Warum das Markup dem sichtbaren Text Wort für Wort entsprechen muss

FAQ-Schema sind strukturierte Daten vom Typ FAQPage — ein JSON-LD-Block, der die Fragen und Antworten einer Seite auflistet —, damit Suchmaschinen und KI-Antwortmaschinen sie als Daten lesen können, statt sie aus dem Layout zu erraten. Das entscheidende Wort ist einer Seite. Googles Richtlinien für strukturierte Daten verlangen, dass ausgezeichnete Inhalte für Leser sichtbar sind und mit dem übereinstimmen, was das Markup behauptet. Eine Seite, deren JSON-LD Fragen auflistet, die kein Besucher sieht, oder Antworten, die vom sichtbaren Text abweichen, verstößt gegen diese Richtlinien und kann durch eine manuelle Maßnahme ihre Berechtigung für strukturierte Daten verlieren.

Die meisten Generatoren hören beim JSON-LD auf und überlassen dir die sichtbare Hälfte. Genau dort beginnt das Auseinanderdriften: Der Text wird im CMS überarbeitet, der Skriptblock nicht, und sechs Monate später beschreibt das Markup eine Seite, die es nicht mehr gibt. Dieser Generator schreibt das sichtbare HTML und das JSON-LD aus derselben Liste im selben Durchgang — der Text im <summary> ist der name, der Text im <p> ist der acceptedAnswer.text, Zeichen für Zeichen. Erzeuge beide neu, sobald du eines änderst, und die zwei können nicht auseinanderlaufen.

Die Regel ist nicht nur eine Frage der Richtlinien. KI-Antwortmaschinen heben den sichtbaren Satz heraus, und wer über dieses Zitat auf der Seite landet, erwartet, ihn dort zu finden. Eine Quelle für beide Oberflächen ist die Art, das sicherzustellen.

Was FAQ-Schema heute bringt — ehrlich

Im August 2023 hat Google FAQ-Rich-Results in der Suche auf bekannte, autoritative Behörden- und Gesundheitswebsites beschränkt. Für alle anderen ist das ausklappbare Frage-Antwort-Snippet unter dem Suchergebnis verschwunden, und jedes Tool, das es noch verspricht, beschreibt das Jahr 2022. Warum also überhaupt eine FAQ auszeichnen?

• Die sichtbare FAQ rankt. Eine Frage, formuliert wie gesucht, in einem sauberen Satz beantwortet, ist ein Seitenabschnitt, der für sich ranken und von einer KI-Maschine zitiert werden kann. Das Markup ist die maschinenlesbare Kopie dieses Abschnitts, nicht der Grund für das Ranking.
• Strukturierte Daten werden weiterhin gelesen. Google verarbeitet FAQPage-Markup auch dort, wo es kein Rich Result anzeigt, und andere Leser — Bing, Antwortmaschinen, deine eigenen Agenten — nutzen es als sauberen Extraktionspfad.
• Die Disziplin zahlt sich woanders aus. Eine Frage als Suchanfrage und eine Antwort als eigenständigen Satz zu schreiben ist genau das, was eine Seite in KI-Antworten zitierbar macht — mit oder ohne JSON-LD.

Was du nicht erwarten solltest: einen Ranking-Schub durch das Markup selbst oder ein Rich Result auf einer kommerziellen Seite. Nutze es, weil die Seite eine echte FAQ hat und ihre zwei Oberflächen übereinstimmen sollen.

Fragen und Antworten, die zitiert werden

• Formuliere die Frage als echte Suchanfrage. Wie kann ich…, Kann ein Agent…, Ist X Pflicht… — so, wie sie ins Suchfeld getippt wird, nicht als Überschrift.
• Beantworte sie vollständig im ersten Satz. Extraktoren nehmen den ersten Satz; der Rest ist Ergänzung.
• Lass jeden Satz für sich stehen. Kein es, dies oder wie oben erwähnt, das nur im Zusammenhang Sinn ergibt — ein zitierter Satz verliert seine Nachbarn.
• Ein Gedanke pro Paar. Eine Frage, die drei Antworten braucht, sind drei Fragen.
• Fakten statt Adjektive. Zahlen mit genannter Quelle werden zitiert; Superlative nicht.
• Nur Fragen, die wirklich gestellt werden. Eine FAQ ist kein Ort, um Werbeaussagen hinter einem Fragezeichen zu verstecken.

Wo der Code hingehört

Das JSON-LD kann überall in der Seite stehen, in einem <script type="application/ld+json"> — head oder body, Google liest beides. Verwende einen FAQPage-Block pro Seite und wiederhole dieselbe Frage nicht auf mehreren Seiten; das Markup beschreibt die Seite, auf der es liegt. Der sichtbare Block gehört dorthin, wo die FAQ gelesen werden soll; <details>/<summary> ist ohne JavaScript auf- und zuklappbar und bleibt für Crawler im HTML.

FAQPage ist für Fragen, die die Website selbst stellt und beantwortet. Eine Seite, auf der Besucher Fragen posten und andere antworten — ein Forumsthread, eine Support-Community — ist eine QAPage, ein anderer Typ. Und das JSON-LD beschreibt nur, was auf der Seite steht: hreflang für deine Sprachversionen und eine llms.txt für Agenten sind eigene Oberflächen, abgedeckt vom hreflang tag generator (englisch) und vom llms.txt Validator — beide nach derselben Regel gebaut wie diese Seite: eine Quelle, zwei Ausgaben, kein Auseinanderdriften.

$ npm i -g @clize/clize && clize install
$ clize seo check --domain deine-domain.de