llms.txt + AEO Schema für WooCommerce — Vollständige Anleitung

Überblick

Das Plugin DataFirefly llms.txt + AEO Schema macht Ihren WooCommerce-Shop für KI-Agenten (ChatGPT, Claude, Perplexity, Gemini) sichtbar und korrekt verständlich. Es kombiniert zwei komplementäre Mechanismen:

• Einen dynamischen /llms.txt-Endpunkt konform zum llmstxt.org-Standard, generiert aus Ihrem Katalog mit Cache pro Sprache.
• Eine Anreicherung des Product-Schemas von WooCommerce mit den Anti-Halluzination-Attributen, nach denen Agenten suchen: Marke, GTIN, Materialien, Kompatibilität, Rückgabe- und Versandrichtlinien, plus ein separates agenten-orientiertes FAQPage-Schema.

Voraussetzungen

• WordPress 6.2 oder höher
• WooCommerce 8.0 oder höher (getestet bis 9.4)
• PHP 8.0 oder höher
• Optional: Polylang oder WPML für die mehrsprachige Generierung

Installation

1. Laden Sie das Archiv dfllmstxtaeo.zip aus Ihrem DataFirefly-Konto herunter.
2. Gehen Sie im WordPress-Admin zu Plugins → Installieren → Plugin hochladen, wählen Sie die ZIP-Datei und klicken Sie auf Jetzt installieren.
3. Aktivieren Sie das Plugin. Die Rewrite-Rule für /llms.txt wird registriert und die Permalinks werden bei der Aktivierung automatisch aktualisiert.
4. Prüfen Sie, ob https://ihreseite.tld/llms.txt antwortet. Bei einem 404 gehen Sie zu Einstellungen → Permalinks und klicken auf Änderungen speichern, um einen Regel-Flush zu erzwingen.

Allgemeine Einstellungen

Die Einstellungsseite finden Sie unter WooCommerce → llms.txt + AEO. Oben wird die URL Ihrer llms.txt mit direktem Vorschau-Link angezeigt.

/llms.txt ausliefern

Vier Schalter steuern die Hauptfunktionen: den llms.txt-Endpunkt, die Produkt-Schema-Anreicherung, die FAQPage-Schema-Ausgabe und die Speakable-Spezifikation. Alles ist standardmäßig aktiviert.

llms.txt-Inhalt

• Produkte / Seiten / Beiträge einbeziehen: wählen Sie, welche Sektionen generiert werden.
• Max. Produkte: von 1 bis 1000 (Standard 200). Die neuesten Produkte stehen zuerst.
• Cache-Dauer: in Minuten, 0 zum Deaktivieren. Der Cache wird ohnehin bei jeder Produkt-, Seiten- oder Einstellungsänderung automatisch geleert.
• Einleitungsabsatz: freier Text (Klartext oder Markdown), eingefügt nach der Site-Beschreibung.

Schema-Standardwerte

• Standard-Markenname: wird verwendet, wenn ein Produkt keine eigene Marke hat.
• Händlerland (ISO-2): leer lassen, um das WooCommerce-Standardland zu verwenden.
• Standard-Rückgabefrist: in Tagen, speist hasMerchantReturnPolicy.
• Rückgabegebühren: kostenlose Rückgabe, Kunde zahlt den Versand, oder Kunde zahlt alle Gebühren.

Der /llms.txt-Endpunkt

Die Datei wird mit den Headern Content-Type: text/markdown; charset=utf-8 und X-Robots-Tag: noindex ausgeliefert (sie richtet sich an KI-Crawler, nicht an den Google-Index). Generierte Sektionen: Produktkategorien, Produkte (Titel, URL, Preis, Kurzbeschreibung), Seiten, Beiträge, sowie die Links zur Datenschutzerklärung und den in WordPress und WooCommerce konfigurierten AGB.

So funktioniert der Cache

Der Inhalt wird in einem sprachbezogenen Transient (dfllmstxtaeo_llms_cache_{lang}) gespeichert. Er wird automatisch invalidiert bei den Hooks save_post_product, save_post_page, deleted_post und bei jedem Speichern der Plugin-Einstellungen.

Mehrsprachigkeit

Polylang und WPML werden automatisch erkannt. Jede Sprache erhält ihre eigene llms.txt unter ihrem URL-Präfix (z. B. /de/llms.txt je nach Polylang-Konfiguration), mit unabhängigem Cache. Ohne Mehrsprachigkeits-Plugin wird das WordPress-Locale verwendet.

Der AEO Schema-Tab bei Produkten

Jedes Produkt erhält einen AEO Schema-Tab im WooCommerce-Datenpanel (Produkt → Bearbeiten).

Verfügbare Felder

• Marke: überschreibt die globale Marke für dieses Produkt. Als Fallback sucht das Plugin nach einem pa_brand– oder brand-Attribut.
• GTIN / EAN / UPC: 8, 12, 13 oder 14 Stellen. Die passende gtin8/12/13/14-Eigenschaft wird automatisch nach Länge hinzugefügt.
• MPN: Herstellerteilenummer.
• Materialien: kommagetrennt (z. B. „Leder, recycelte Baumwolle“). Ein einzelnes Material erzeugt einen String, mehrere erzeugen ein Array.
• Kompatibel mit: ein Eintrag pro Zeile. Jede Zeile wird zu einem isRelatedTo-Eintrag vom Typ Product.

Agenten-orientierte FAQ

Unter den Feldern erlaubt die Sektion Agenten-orientierte FAQ, kurze, sachliche Frage/Antwort-Paare hinzuzufügen (exakte Kompatibilität, Maße, Inhaltsstoffe, Zertifizierungen). Sie speisen ein separates FAQPage-JSON-LD-Schema, das nur auf Produktseiten mit mindestens einem Eintrag ausgegeben wird. Diese FAQ ist im Frontend unsichtbar: sie erscheint nicht im Theme, sie existiert ausschließlich für Agenten.

Hinzugefügte Schema.org-Felder

Auf dem Product-Objekt: brand, gtin (+ gtin8/12/13/14), mpn, material, color, size, weight, height, width, depth (QuantitativeValue mit den WooCommerce-Einheiten), isRelatedTo, speakable. Auf jedem Offer: seller (Organization mit Site-Name und URL), hasMerchantReturnPolicy (Land, Frist in Tagen, Gebührenart), shippingDetails (Ziel, deliveryTime mit 0-1 Tag handlingTime und 1-5 Tagen transitTime).

Die Felder color und size werden automatisch aus den Attributen pa_color / color und pa_size / size übernommen, sofern vorhanden. Gewicht und Maße stammen aus den nativen Versandfeldern des Produkts.

Kompatibilität mit SEO-Plugins

Das Plugin wirkt ausschließlich über den nativen Filter woocommerce_structured_data_product, der nur das von WooCommerce selbst erzeugte JSON-LD betrifft. Yoast SEO, RankMath und SEO Press geben ihre Blöcke unabhängig über wp_head aus: keine Kollision. Bereits im WooCommerce-Schema vorhandene Werte bleiben erhalten.

Entwickler-Hooks

• dfllmstxtaeo_llms_output: filtert den finalen llms.txt-Inhalt. Argumente: der Inhalt (String) und der Sprachcode.
• dfllmstxtaeo_product_schema: filtert das angereicherte Schema-Array vor der Ausgabe. Argumente: das Markup-Array und das WC_Product-Objekt.

add_filter( 'dfllmstxtaeo_product_schema', function ( $markup, $product ) {
    $markup['award'] = 'Design-Preis 2026';
    return $markup;
}, 10, 2 );

Fehlerbehebung

• /llms.txt liefert einen 404: speichern Sie die Permalinks neu (Einstellungen → Permalinks → Änderungen speichern).
• Die Datei zeigt eine kürzliche Änderung nicht: der Cache wird beim Bearbeiten geleert, aber Sie können es erzwingen, indem Sie die Cache-Dauer vorübergehend auf 0 setzen oder die Einstellungen neu speichern.
• FAQPage erscheint nicht: prüfen Sie, ob das Produkt mindestens ein vollständiges Frage/Antwort-Paar hat und die Option „FAQPage-Schema ausgeben“ aktiv ist.
• Schema validieren: testen Sie eine Produkt-URL mit dem schema.org-Validator oder dem Google Rich-Results-Tool, um das vollständige JSON-LD zu prüfen.