Merkmale und Vorteile des Moduls
- Markdown wird aus PrestaShop-Objekten aufgebaut und nicht durch Konvertierung der gerenderten Seite — das Dokument enthält weder Menü, Footer, Formulare noch Code anderer Module.
- Radikal geringere Token-Kosten auf Agentenseite: Der Header X-Markdown-Tokens-Estimate gibt in jeder Antwort die geschätzte Dokumentgröße an, und das Panel zeigt einen Vergleich von Markdown gegenüber HTML für die angegebene Entität.
- Zwei unabhängige Bereitstellungskanäle — Inhaltsaushandlung unter der kanonischen Adresse sowie separate .md-Adressen — sodass der Agent den Inhalt erreicht, unabhängig davon, ob er den Header Accept sendet.
- Diagnostische Sicherheitsprüfung vor dem Aktivieren der Aushandlung: Das Modul erlaubt das Einschalten der Funktion erst, nachdem es mit echten HTTP-Anfragen gemessen hat, dass ein zwischengeschalteter Cache die gemeinsame Cache-Speicherung nicht vergiftet.
- Die Regel „der Agent sieht nie mehr als ein Gast“ ist als Grundsatz und nicht als einzelne Ausnahme umgesetzt — die Sichtbarkeitseinstellungen des Shops gelten gegenüber Agenten genauso wie gegenüber einem anonymen Besucher.
- Preise werden im Gastkontext berechnet, mit expliziter Auflösung von Währung und Land, sodass der Cache nicht den Preis eines Kunden speichert und ihn allen übrigen ausliefert.
- Volle Unterstützung für Multistore und Mehrsprachigkeit: Einstellungen, llms-Dateien, Cache und Zähler werden für jeden Shop und jede Sprache getrennt geführt.
- Keine externen Abhängigkeiten — kein Composer, keine externen Bibliotheken, keine Aufrufe an Drittanbieterdienste; das Modul sendet die Daten Ihres Shops nirgendwohin außer in der Antwort auf die Anfrage.
- Es werden keine personenbezogenen Daten gesammelt: Der Trefferzähler speichert ausschließlich Tag, Shop, Kanal und Client-Familie, ohne IP-Adressen, Sitzungen, vollständige URLs und vollständigen User-Agent.
- Kompatibilität von PrestaShop 1.7.1.0 bis 9.x und von PHP 7.0 bis 8.5, anhand realer Quellbäume verifiziert und nicht nur deklarativ.
Wichtigste Funktionen des Moduls
- Inhaltsaushandlung auf den kanonischen Shop-Adressen: Eine Anfrage mit Accept: text/markdown erhält ein Markdown-Dokument, eine Browser-Anfrage erhält unverändertes HTML.
- Header Vary: Accept sowie Kennzeichnung Link: rel="alternate" auf den vom Modul abgedeckten HTML-Seiten, damit Vermittler und Agenten wissen, dass eine alternative Version existiert.
- Parallele Adressen markdown/{typ}/{id}.md für Produkte, Kategorien, CMS-Seiten und Hersteller, unter eigenem Präfix, damit sie nicht mit anderen Modulen kollidieren, die Adressen umschreiben.
- Datei llms.txt — ein kuratiertes Verzeichnis der wichtigsten Shop-Bereiche: Kategorien der obersten Ebene, Informationsseiten und ein Verweis auf den vollständigen Index.
- Datei llms-full.txt — ein kompakter Entitätsindex: Titel, kanonische Adresse, .md-Adresse, Preis, Verfügbarkeit, SKU und Zusammenfassung; wird nach Überschreiten der konfigurierten Größe automatisch in Teile aufgeteilt.
- Erzeugung von llms-full.txt ausschließlich über einen token-geschützten Cron-Endpunkt, niemals während einer Besucheranfrage, mit Zeitbudget und Wiederaufnahme eines unterbrochenen Neuaufbaus.
- Separates Cron-Token für jeden Shop, mit konstanter Zeit verglichen, mit einem im Panel fertig zum Kopieren bereitgestellten curl-Befehl.
- Cache des erzeugten Markdown in der Datenbank mit konfigurierbarer Lebensdauer sowie Invalidierung per Hooks bei Änderungen an Produkt, Kombination, Aktionspreis, Preisregel, Lagerbestand, Kategorie, CMS-Seite und Hersteller.
- Registerkarte Diagnose: sieben Prüfungen, ausgeführt mit echten HTTP-Anfragen gegen den eigenen Probe-Endpunkt des Moduls, mit separater Unterscheidung der Fehler „HTML an den Agenten geliefert“ und „Markdown an den Browser geliefert“.
- Informative Prüfung der tatsächlichen Katalogadresse nach dem Aktivieren der Aushandlung, separat dargestellt und ohne Sperrwirkung für die Funktion.
- Dokumentvorschau im Panel für den angegebenen Entitätstyp und die Entitäts-ID, zusammen mit einem Token-Zähler für Markdown gegenüber HTML und einem expliziten Sichtbarkeitsurteil der Entität.
- Registerkarte Dateien: Status der llms-Dateien für jede Sprache (Vorhandensein, Größe, Datum, Anzahl der Entitäten, Anzahl der Teile), Schaltfläche für manuellen Neuaufbau mit Zeitbudget und Cron-Befehl.
- Trefferzähler für Agenten: Aggregat Tag × Shop × Kanal × Client-Familie, mit Aufteilung in die Kanäle Aushandlung, .md-Route und llms sowie die Familien openai, anthropic, perplexity, google, bing, script, browser und other.
- Antwort-Header passend zum Verwendungszweck des Inhalts: X-Robots-Tag: noindex, nofollow auf Markdown-Dokumenten, X-Content-Type-Options: nosniff, ETag mit Unterstützung für 304 sowie differenzierte Cache-Control-Richtlinie für die kanonische Adresse und die .md-Adresse.
- Produktdaten im Dokument-Header: Typ, Kennung, kanonische Adresse, Markdown-Adresse, Titel, SKU, Marke, Bruttopreis und Nettopreis, Währung, Steuerinformation, Verfügbarkeit, Kennzeichnung als Set, Personalisierungspflicht, Produktzustand, Kategorien, Sprache und Aktualisierungsdatum.
- Regulärer Preis sowie Höhe und Prozentsatz des Rabatts, wenn das Produkt von einer Aktion betroffen ist — der Agent sieht den Aktionspreis nicht als normalen Preis.
- Variantentabelle mit Preis, Menge, Verfügbarkeit und Kombinations-ID, sodass der Agent eine konkrete Variante angeben und nicht nur beschreiben kann.
- Inhalt von Produktsets mit Mengenangaben und Verweisen auf die Markdown-Dokumente der einzelnen Positionen.
- Information über erforderliche Personalisierungsfelder, unter Auslassung von Feldern anderer Module, die PrestaShop im Frontend nicht anzeigt.
- Auswahl der Entitätstypen, die Agenten bereitgestellt werden, einheitlich durchgesetzt in allen Kanälen: auf .md-Routen, in llms-Dateien und in der Kennzeichnung der alternativen Version.
- Arbeitsverzeichnis des Moduls gegen direktes Auslesen aus dem Netz geschützt, und llms-Dateien werden ausschließlich über die Controller des Moduls ausgeliefert.
- Beachtung des Wartungsmodus und der Geolokalisierung des Shops — ein für Besucher geschlossener Shop ist auch für Agenten geschlossen.
- Panel im PD-Stil mit Modul-Header und Registerkartenleiste, mit Hinweisen bei Einstellungen mit kostspieligen Folgen, wie etwa der Fragmentierung des CDN-Caches.
Geschäftlicher Einsatz
- Für PrestaShop-Shops, die von Einkaufsassistenten und KI-Agenten korrekt gelesen werden sollen, statt darauf zu hoffen, dass das Modell die HTML-Seite selbstständig entrauscht.
- Für Händler, die kontrollieren möchten, was genau an Agenten übermittelt wird — den Umfang der Entitätstypen, die Sichtbarkeit von Preisen und Mengen sowie die Art der Veröffentlichung.
- Für Shops mit umfangreichem Katalog, in denen der Unterschied zwischen einer vollständigen HTML-Seite und einem Markdown-Dokument zu einem realen Kostenunterschied auf Seiten des Abfragenden führt.
- Für Multistore-Implementierungen, bei denen jeder Shop eigene Einstellungen, eigene llms-Dateien und ein eigenes Cron-Token benötigt.
- Für Unternehmen, die die Entscheidung über weitere Investitionen in diesen Kanal auf Daten stützen möchten — der Trefferzähler zeigt, ob und auf welchem Weg Agenten tatsächlich anfragen.
- Für Shops hinter CDN oder Reverse Proxy, bei denen das eigenständige Aktivieren der Inhaltsaushandlung ohne Verifikation dazu führen könnte, dass normalen Kunden die falsche Seitenversion ausgeliefert wird.
Was das Modul nicht macht
- Es ist kein SEO-Modul und verbessert nicht die Position des Shops in den Google-Suchergebnissen — Markdown-Dokumente sind ausdrücklich als nicht indexierbar gekennzeichnet.
- Es verändert weder Aussehen, Inhalt noch Leistung der von Kunden gesehenen HTML-Seite; eine vom Modul abgedeckte Seite erhält ausschließlich zusätzliche Header, die über das Vorhandensein einer alternativen Version informieren.
- Es sendet keine Shop-Daten an irgendeinen externen Dienst und erfordert weder ein Konto noch einen API-Schlüssel.
- Es übersetzt die strukturellen Bezeichnungen des Dokuments nicht — die Feldnamen bleiben fest und englisch, da sie für die Maschine bestimmt sind, während der Inhalt der Entität immer in der Sprache des Shops vorliegt.
Kompatibilität
- PrestaShop: 1.7.1.0 - 9.x
- PHP: 7.0 - 8.5
- Ohne Composer und ohne externe Bibliotheken
- Multistore: ja, Einstellungen und Dateien werden für jeden Shop getrennt geführt
- Mehrsprachigkeit: ja, Dokumente und llms-Dateien für jede aktive Sprache