# 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… - Seite: - Sprache: de - Aktualisiert am: 2026-08-06 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/llms-txt-aeo-schema-woocommerce/index.md), [en](https://www.datafirefly.com/en/documentation/llms-txt-aeo-schema-woocommerce/index.md), [es](https://www.datafirefly.com/es/documentation/llms-txt-aeo-schema-woocommerce/index.md), [it](https://www.datafirefly.com/it/documentation/llms-txt-aeo-schema-woocommerce/index.md), [pl](https://www.datafirefly.com/pl/documentation/llms-txt-aeo-schema-woocommerce/index.md), [nl](https://www.datafirefly.com/nl/documentation/llms-txt-aeo-schema-woocommerce/index.md), [pt](https://www.datafirefly.com/pt/documentation/llms-txt-aeo-schema-woocommerce/index.md) - Index: ## Ü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. Formulieren Sie Antworten als überprüfbare Fakten, nicht als Verkaufsargumente. Ein Agent, der „kompatibel mit den Modellen X, Y und Z" liest, zitiert genau diese Modelle; ein Agent, der „kompatibel mit den meisten Geräten" liest, erfindet die Liste. ## 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.