Macht deinen Shop für ChatGPT, Perplexity, Claude, Gemini und Copilot lesbar und zeigt dir, was KI an Besuchern und Umsatz bringt. Alle Daten kommen aus deinem Shop und der JTL-Wawi, ohne Template-Änderung und ohne weiteres Plugin.
Im JTL Extension Store ansehen
Was das Plugin macht
- KI-Bots steuern: 40 KI-Bots einzeln erlauben oder sperren, getrennt nach „Suchen und Zitieren“ und „Training“. Das Plugin schreibt einen eigenen Block in die robots.txt, deine Regeln bleiben erhalten.
- llms.txt und llms-full.txt: Steckbrief des Shops für KI je Sprache, automatisch aktuell.
- Jede Seite maschinenlesbar: Produkt-, Kategorie-, Content- und Blogseiten auch als
.mdund.json. - JSON-LD: Produkt, Angebot, Versand, Rückgabe, Bewertungen, Breadcrumbs und FAQ direkt im HTML für Google und KI.
- Produkt-Feed und MCP-Server: für Shopping-Agenten, Claude und ChatGPT. Nur lesend.
- OpenAI-Feed und Agent-Readiness: Produkt-Feed im Format für ChatGPT Shopping, dazu ein Score, der zeigt, welche Pflichtfelder in deinen Artikeln noch fehlen.
- KI-Umsatz: Besuche, Bestellungen und Umsatz je KI-Assistent, ohne Cookies und ohne IP.
- Analyse: Bot-Statistik, Zitierbarkeits-Score je Artikel, Sichtbarkeits-Check in ChatGPT und Claude.
- IndexNow: meldet geänderte Artikel und Kategorien an Bing und Partner.
Voraussetzungen
- JTL-Shop 5.5 bis 5.8, PHP 8.2 bis 8.4 (JTL-Shop 5.8 selbst braucht PHP 8.3)
robots.txtim Shop-Hauptverzeichnis beschreibbar (sonst Bot-Steuerung nur als Hinweis)- Aktiver JTL-Shop-Cronjob
- Für MCP in Claude oder ChatGPT: ein Konto beim jeweiligen Anbieter
- Optional für KI-Textvorschläge und Sichtbarkeits-Check: eigener API-Key von Anthropic oder OpenAI
Installation
- Im Shop-Backend unter Produkte / ExtensionStore / Meine Erweiterungen das Plugin dem Shop zuordnen und installieren.
- Unter Erweiterungen / Plugin-Verwaltung aktivieren.
- NZ GEO Visibility öffnen, Tab GEO. Beim ersten Öffnen führt ein kurzer Assistent durch die Einrichtung.
Die Installation ändert deine robots.txt nicht. Den Plugin-Block schreibt das Plugin erst, wenn du den Assistenten abschließt, über den Knopf „robots.txt schreiben“ oder beim Speichern der Bot-Auswahl.
Updates erscheinen automatisch unter „Meine Erweiterungen“ und werden dort per Klick installiert. Einstellungen und Statistiken bleiben erhalten.
Tipp: Sichere vor der Installation deine bestehende robots.txt. Öffne dazu https://DEIN-SHOP/robots.txt im Browser und speichere den Text.
Einrichtung in 6 Schritten
- Start: „llms.txt neu erzeugen“ klicken, falls angezeigt.
- KI-Bots: Freigaben prüfen und „Speichern“. Empfehlung: „Suchen und Zitieren“ erlauben (bringt Sichtbarkeit), „Training“ nach eigener Entscheidung.
- KI-Inhalt / Inhalte pflegen: Eckdaten prüfen, empfohlene Produkte wählen, Eigene Felder anhaken, die nach außen dürfen (z. B. Lieferumfang, Technische Daten). Ohne Auswahl gehen keine eigenen Felder raus.
- KI-Inhalt / FAQ: „Aus Shop-Daten erzeugen“ legt Fragen zu Versand, Zahlung, Preisen, Rückgabe und Kontakt in allen Sprachen an. Erneutes Klicken aktualisiert die Antworten, ohne doppelte Einträge.
- Einstellungen / Versand und Rückgabe: Rückgabe wählen: „Mit Rückgabefrist“, „Keine Rückgabe (z. B. B2B)“ oder „Keine Angabe“.
- Datenschutzerklärung ergänzen (Textbaustein im Abschnitt Datenschutz).
Das Menü im Überblick
- Start: Zu erledigen, Kennzahlen (KI-Besucher, KI-Bots, Zitierbarkeit, llms.txt), letzte Ereignisse, aktive Module.
- KI-Bots: Freigaben je Bot, Statistik (Zugriffe je Bot und Tag, Top-Seiten).
- KI-Umsatz: Umsatz, Bestellungen, Conversion und Bestellwert je KI-Assistent.
- KI-Inhalt: Inhalt und Vorschau der llms.txt, Ausschlüsse (Kategorien oder Artikel aus der KI-Ausgabe nehmen), Inhalte pflegen, FAQ.
- Strukturierte Daten: JSON-LD und offizielle Profile (Wikidata, LinkedIn, Instagram usw.).
- Schnittstellen für KI: alle öffentlichen Adressen, Zugangsschlüssel, MCP-Connector, Feeds und die Karte Agent-Readiness mit Score, vollständigen Zeilen und den häufigsten fehlenden Feldern samt Hinweis zur Behebung.
- Seiten: alle sichtbaren Shop-Seiten mit ihren
.md- und.json-Versionen. - Zitierbarkeit: Score 0 bis 100 je Artikel mit Ampel und konkreten Lücken, CSV-Export, optionale KI-Textvorschläge. Der Score prüft auch die Pflichtfelder des OpenAI-Feeds und legt je Artikel eine Aufgabe an, etwa „OpenAI-Feed: Pflichtfelder fehlen (brand, price)“.
- KI-Sichtbarkeit: prüft mit eigenen Fragen, ob ChatGPT oder Claude deinen Shop nennen (braucht API-Key).
- Einstellungen: siehe Wichtige Einstellungen.
Wichtige Einstellungen
| Einstellung | Standard | Wofür |
|---|---|---|
| Preisangabe | Wie im Shop | Netto oder brutto so, wie Gäste die Preise sehen. Brutto oder netto erzwingbar. |
| Content-Type der KI-Ausgaben | Maximale Kompatibilität | text/plain und application/json, damit Claude und ChatGPT die Dateien auch hinter strengen Server-Headern lesen. |
| Feed ohne API-Key | an | Shopping-Agenten lesen den Feed ohne Schlüssel (Rate-Limit je IP). |
| MCP ohne API-Key | aus | Nötig für den Connector in Claude oder ChatGPT ohne eigenen Header. |
| Rate-Limit | 120 pro Minute | Anfragen je Schlüssel bzw. IP. 0 = aus. |
| Vertrauenswürdige Proxys | leer | Nur hinter Cloudflare oder Load-Balancer: deren IP-Bereiche eintragen, damit das Rate-Limit je echter Besucher-IP zählt. |
| KI-Umsatz erfassen | an | Ordnet Bestellungen der KI-Quelle zu. |
| Rückgabe | Mit Rückgabefrist (14 Tage) | Rückgaberichtlinie im JSON-LD, in der llms.txt und in den .md-Dateien. |
Automatisch berücksichtigt: Stellt der Shop „Preise nur nach Login“ ein, fallen alle Preise aus den KI-Ausgaben. Bei „Shop nur nach Login“ gibt das Plugin öffentlich nichts aus. Ist der Shop im Wartungsmodus, gilt das auch für die KI-Ausgaben.
Öffentliche Adressen
| Adresse | Inhalt |
|---|---|
/robots.txt | Regeln für KI-Bots (Block # BEGIN nz_geo bis # END nz_geo) |
/llms.txt, /.well-known/llms.txt | kompakter Shop-Steckbrief, andere Sprache mit ?lang=eng |
/llms-full.txt | ausführliche Fassung mit vollständiger Produktliste |
/<seite>.md | jede Shop-Seite als Markdown (auch per Accept: text/markdown) |
/<seite>.json | jede Shop-Seite als JSON-LD, Startseite /index.json |
/feed.jsonl, /geo/feed.json | Produkt-Feed, Parameter offset/limit bzw. page/limit, Filter category, inStock, updatedSince |
/geo/openai-feed.jsonl | Produkt-Feed im OpenAI-Commerce-Format (ChatGPT Shopping), Varianten als eigene Zeilen, Parameter offset und limit (max. 500), nächste Seite im Header X-Next-Page. Nur Suche, kein Checkout. |
/geo/mcp | MCP-Server (JSON-RPC, Streamable HTTP), nur lesend. Nur POST, ein GET antwortet mit 405. |
MCP-Server verbinden
Adresse: https://DEIN-SHOP/geo/mcp. Für Claude und ChatGPT schaltest du unter Einstellungen „MCP ohne API-Key“ ein.
Wichtig ab Version 1.2.0: Der MCP-Server nimmt den API-Key nur noch im Header X-API-Key an (oder als Authorization: Bearer, wenn dein Webserver diesen Header an PHP weiterreicht). ?key= in der URL geht beim MCP-Server nicht mehr, weil URLs in Server- und Proxy-Logs landen. Hast du /geo/mcp?key=... eingetragen, stell bitte auf den Header um. Beim Feed funktioniert ?key= weiter, empfohlen ist auch dort der Header.
- Claude: Einstellungen, Connectors, „Benutzerdefinierten Connector hinzufügen“, URL eintragen.
- ChatGPT: Einstellungen, Apps und Connectors, Entwicklermodus, neuen Connector mit der URL anlegen.
- Claude Code (mit Schlüssel):
claude mcp add --transport http mein-shop https://DEIN-SHOP/geo/mcp --header "X-API-Key: DEIN-KEY"Werkzeuge: search_products, get_product, list_categories, get_category, get_page, check_availability, get_price sowie search und fetch für ChatGPT. Keine Schreib- oder Bestellfunktion.
Hinweis: Die Menünamen bei Claude und ChatGPT ändern sich gelegentlich.
Datenschutz
Keine Kundendaten in llms.txt, Feed, MCP oder JSON-LD. Alle Schnittstellen sind nur lesend.
| Funktion | Gespeichert | Personenbezug | Löschung |
|---|---|---|---|
| KI-Bot-Log | Zeitpunkt, Bot, Pfad (ohne Query-String), Status, IP-Adresse. Höchstens ein Eintrag je Bot und Pfad pro Minute. | IP-Adresse | IP nach 30 Tagen, Eintrag nach 180 Tagen, abschaltbar |
| Besucher über KI | Zeitpunkt, Quelle, Einstiegsseite (ohne Query-String) | keiner (keine IP, kein Cookie, keine Session-ID) | nach 400 Tagen, abschaltbar |
| KI-Umsatz | Bestellnummer, Summe, KI-Quelle | Bestellnummer | abschaltbar |
| KI-Sichtbarkeit | Prüf-Fragen, Antworten, Quellen | keiner | manuell löschbar |
An Dritte geht nur:
- KI-Anbieter (optional): nur mit eigenem API-Key und nur bei „KI-Vorschlag“ oder „Sichtbarkeit prüfen“: Artikeldaten bzw. Prüf-Fragen an Anthropic oder OpenAI. Keine Kundendaten.
- IndexNow: öffentliche URLs geänderter Artikel und Kategorien an Bing und Partner. Abschaltbar.
Textbaustein für die Datenschutzerklärung (kein Rechtsrat, bitte prüfen lassen):
Wenn automatisierte Programme von KI-Diensten (z. B. GPTBot, ClaudeBot, PerplexityBot) unsere Seiten abrufen, speichern wir Zeitpunkt, Bezeichnung des Programms, aufgerufene Seite, Statuscode und IP-Adresse. Zweck ist die Steuerung und Absicherung des Zugriffs durch solche Programme. Rechtsgrundlage ist unser berechtigtes Interesse nach Art. 6 Abs. 1 lit. f DSGVO. Die IP-Adresse wird nach 30 Tagen gelöscht, die übrigen Angaben nach 180 Tagen. Besuche, die über einen KI-Assistenten auf unsere Seite führen, zählen wir ohne IP-Adresse, Cookies oder sonstige Kennungen.Lizenz und Updates
- Lizenz über den JTL Extension Store, 14 Tage kostenlos testen, Subscription mit 12 Monaten Updates und Support.
- Läuft die Lizenz ab, schaltet das Plugin alle öffentlichen Ausgaben und den Cron ab. Admin, Einstellungen und Statistiken bleiben. Nach Verlängerung ist es sofort wieder aktiv.
- Die Deinstallation entfernt robots.txt-Block, Cronjob, Cache und auf Wunsch alle Daten.
Häufige Fragen
- Die robots.txt wird nicht geschrieben. Die Datei ist nicht beschreibbar. Prüf die Rechte beim Hoster oder füge den Block aus „Schnittstellen für KI“ von Hand ein.
- /llms.txt zeigt kurz „Being generated“. Die Datei wird gerade zum ersten Mal gebaut. Nach einer Minute neu laden oder auf Start „llms.txt neu erzeugen“ klicken.
- /llms.txt zeigt nicht den Inhalt des Plugins. Im Shop-Hauptverzeichnis liegt eine fremde
llms.txt. Entferne sie per FTP. - Der MCP-Connector verbindet sich nach dem Update nicht mehr. Seit Version 1.2.0 geht der API-Key beim MCP-Server nur noch per Header
X-API-Key, nicht mehr als?key=in der URL. Stell den Connector auf den Header um oder schalte „MCP ohne API-Key“ ein. - Der Feed antwortet mit 429. Das Rate-Limit ist erreicht. Hinter Cloudflare die Proxy-Bereiche unter „Vertrauenswürdige Proxys“ eintragen.
- Google Search und Bing werden nicht gesperrt? Richtig. Das Plugin steuert nur KI-Bots, normale Suchmaschinen folgen weiter deinen eigenen Regeln.
Support
- E-Mail: info@nucez.de, Antwort in der Regel innerhalb eines Werktags.
- Im Store zubuchbar: Installationsservice (49 €) und Einrichtungsservice per Videocall (129 €, max. 60 Minuten).
