{
    "url": "https://nucez.com/docs/nz-geo-visibility",
    "lang": "de",
    "title": "NZ GEO Visibility Dokumentation | Nucez Software",
    "description": "Installation, Einrichtung und Referenz für NZ GEO Visibility, das JTL-Shop-5-Plugin für KI-Sichtbarkeit, llms.txt, MCP und KI-Umsatz.",
    "alternates": [],
    "markdown_url": "https://nucez.com/docs/nz-geo-visibility.md",
    "sections": [
        {
            "heading": "NZ GEO Visibility für JTL-Shop 5",
            "level": 1,
            "content": "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.\n\nVersion 1.2.0 · JTL-Shop 5.5 bis 5.8 · PHP 8.2 bis 8.4 · Admin Deutsch und Englisch"
        },
        {
            "heading": "[Was das Plugin macht](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "- **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.\n- **llms.txt und llms-full.txt:** Steckbrief des Shops für KI je Sprache, automatisch aktuell.\n- **Jede Seite maschinenlesbar:** Produkt-, Kategorie-, Content- und Blogseiten auch als `.md` und `.json`.\n- **JSON-LD:** Produkt, Angebot, Versand, Rückgabe, Bewertungen, Breadcrumbs und FAQ direkt im HTML für Google und KI.\n- **Produkt-Feed und MCP-Server:** für Shopping-Agenten, Claude und ChatGPT. Nur lesend.\n- **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.\n- **KI-Umsatz:** Besuche, Bestellungen und Umsatz je KI-Assistent, ohne Cookies und ohne IP.\n- **Analyse:** Bot-Statistik, Zitierbarkeits-Score je Artikel, Sichtbarkeits-Check in ChatGPT und Claude.\n- **IndexNow:** meldet geänderte Artikel und Kategorien an Bing und Partner."
        },
        {
            "heading": "[Voraussetzungen](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "- JTL-Shop 5.5 bis 5.8, PHP 8.2 bis 8.4 (JTL-Shop 5.8 selbst braucht PHP 8.3)\n- `robots.txt` im Shop-Hauptverzeichnis beschreibbar (sonst Bot-Steuerung nur als Hinweis)\n- Aktiver JTL-Shop-Cronjob\n- Für MCP in Claude oder ChatGPT: ein Konto beim jeweiligen Anbieter\n- Optional für KI-Textvorschläge und Sichtbarkeits-Check: eigener API-Key von Anthropic oder OpenAI"
        },
        {
            "heading": "[Installation](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "1. Im Shop-Backend unter **Produkte / ExtensionStore / Meine Erweiterungen** das Plugin dem Shop zuordnen und installieren.\n2. Unter **Erweiterungen / Plugin-Verwaltung** aktivieren.\n3. **NZ GEO Visibility** öffnen, Tab **GEO**. Beim ersten Öffnen führt ein kurzer Assistent durch die Einrichtung.\n\nDie 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.\n\nUpdates erscheinen automatisch unter „Meine Erweiterungen“ und werden dort per Klick installiert. Einstellungen und Statistiken bleiben erhalten.\n\n**Tipp:** Sichere vor der Installation deine bestehende robots.txt. Öffne dazu `https://DEIN-SHOP/robots.txt` im Browser und speichere den Text."
        },
        {
            "heading": "[Einrichtung in 6 Schritten](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "1. **Start:** „llms.txt neu erzeugen“ klicken, falls angezeigt.\n2. **KI-Bots:** Freigaben prüfen und „Speichern“. Empfehlung: „Suchen und Zitieren“ erlauben (bringt Sichtbarkeit), „Training“ nach eigener Entscheidung.\n3. **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.\n4. **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.\n5. **Einstellungen / Versand und Rückgabe:** Rückgabe wählen: „Mit Rückgabefrist“, „Keine Rückgabe (z. B. B2B)“ oder „Keine Angabe“.\n6. **Datenschutzerklärung** ergänzen (Textbaustein im Abschnitt Datenschutz)."
        },
        {
            "heading": "[Das Menü im Überblick](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "- **Start:** Zu erledigen, Kennzahlen (KI-Besucher, KI-Bots, Zitierbarkeit, llms.txt), letzte Ereignisse, aktive Module.\n- **KI-Bots:** Freigaben je Bot, Statistik (Zugriffe je Bot und Tag, Top-Seiten).\n- **KI-Umsatz:** Umsatz, Bestellungen, Conversion und Bestellwert je KI-Assistent.\n- **KI-Inhalt:** Inhalt und Vorschau der llms.txt, Ausschlüsse (Kategorien oder Artikel aus der KI-Ausgabe nehmen), Inhalte pflegen, FAQ.\n- **Strukturierte Daten:** JSON-LD und offizielle Profile (Wikidata, LinkedIn, Instagram usw.).\n- **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.\n- **Seiten:** alle sichtbaren Shop-Seiten mit ihren `.md`- und `.json`-Versionen.\n- **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)“.\n- **KI-Sichtbarkeit:** prüft mit eigenen Fragen, ob ChatGPT oder Claude deinen Shop nennen (braucht API-Key).\n- **Einstellungen:** siehe Wichtige Einstellungen."
        },
        {
            "heading": "[Wichtige Einstellungen](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "| Einstellung | Standard | Wofür |\n| --- | --- | --- |\n| Preisangabe | Wie im Shop | Netto oder brutto so, wie Gäste die Preise sehen. Brutto oder netto erzwingbar. |\n| 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. |\n| Feed ohne API-Key | an | Shopping-Agenten lesen den Feed ohne Schlüssel (Rate-Limit je IP). |\n| MCP ohne API-Key | aus | Nötig für den Connector in Claude oder ChatGPT ohne eigenen Header. |\n| Rate-Limit | 120 pro Minute | Anfragen je Schlüssel bzw. IP. 0 = aus. |\n| Vertrauenswürdige Proxys | leer | Nur hinter Cloudflare oder Load-Balancer: deren IP-Bereiche eintragen, damit das Rate-Limit je echter Besucher-IP zählt. |\n| KI-Umsatz erfassen | an | Ordnet Bestellungen der KI-Quelle zu. |\n| Rückgabe | Mit Rückgabefrist (14 Tage) | Rückgaberichtlinie im JSON-LD, in der llms.txt und in den `.md`-Dateien. |\n\n**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."
        },
        {
            "heading": "[Öffentliche Adressen](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "| Adresse | Inhalt |\n| --- | --- |\n| `/robots.txt` | Regeln für KI-Bots (Block `# BEGIN nz_geo` bis `# END nz_geo`) |\n| `/llms.txt`, `/.well-known/llms.txt` | kompakter Shop-Steckbrief, andere Sprache mit `?lang=eng` |\n| `/llms-full.txt` | ausführliche Fassung mit vollständiger Produktliste |\n| `/<seite>.md` | jede Shop-Seite als Markdown (auch per `Accept: text/markdown`) |\n| `/<seite>.json` | jede Shop-Seite als JSON-LD, Startseite `/index.json` |\n| `/feed.jsonl`, `/geo/feed.json` | Produkt-Feed, Parameter `offset`/`limit` bzw. `page`/`limit`, Filter `category`, `inStock`, `updatedSince` |\n| `/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. |\n| `/geo/mcp` | MCP-Server (JSON-RPC, Streamable HTTP), nur lesend. Nur POST, ein GET antwortet mit 405. |"
        },
        {
            "heading": "[MCP-Server verbinden](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "Adresse: `https://DEIN-SHOP/geo/mcp`. Für Claude und ChatGPT schaltest du unter Einstellungen „MCP ohne API-Key“ ein.\n\n**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.\n\n- **Claude:** Einstellungen, Connectors, „Benutzerdefinierten Connector hinzufügen“, URL eintragen.\n- **ChatGPT:** Einstellungen, Apps und Connectors, Entwicklermodus, neuen Connector mit der URL anlegen.\n- **Claude Code** (mit Schlüssel):\n\nclaude mcp add --transport http mein-shop https://DEIN-SHOP/geo/mcp --header \"X-API-Key: DEIN-KEY\"\n\n**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.\n\nHinweis: Die Menünamen bei Claude und ChatGPT ändern sich gelegentlich."
        },
        {
            "heading": "[Datenschutz](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "Keine Kundendaten in llms.txt, Feed, MCP oder JSON-LD. Alle Schnittstellen sind **nur lesend**.\n\n| Funktion | Gespeichert | Personenbezug | Löschung |\n| --- | --- | --- | --- |\n| 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 |\n| Besucher über KI | Zeitpunkt, Quelle, Einstiegsseite (ohne Query-String) | keiner (keine IP, kein Cookie, keine Session-ID) | nach 400 Tagen, abschaltbar |\n| KI-Umsatz | Bestellnummer, Summe, KI-Quelle | Bestellnummer | abschaltbar |\n| KI-Sichtbarkeit | Prüf-Fragen, Antworten, Quellen | keiner | manuell löschbar |\n\nAn Dritte geht nur:\n\n- **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.\n- **IndexNow:** öffentliche URLs geänderter Artikel und Kategorien an Bing und Partner. Abschaltbar.\n\n**Textbaustein für die Datenschutzerklärung** (kein Rechtsrat, bitte prüfen lassen):\n\nWenn 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."
        },
        {
            "heading": "[Lizenz und Updates](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "- Lizenz über den JTL Extension Store, **14 Tage kostenlos testen**, Subscription mit 12 Monaten Updates und Support.\n- 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.\n- Die Deinstallation entfernt robots.txt-Block, Cronjob, Cache und auf Wunsch alle Daten."
        },
        {
            "heading": "[Häufige Fragen](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "- **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.\n- **/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.\n- **/llms.txt zeigt nicht den Inhalt des Plugins.** Im Shop-Hauptverzeichnis liegt eine fremde `llms.txt`. Entferne sie per FTP.\n- **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.\n- **Der Feed antwortet mit 429.** Das Rate-Limit ist erreicht. Hinter Cloudflare die Proxy-Bereiche unter „Vertrauenswürdige Proxys“ eintragen.\n- **Google Search und Bing werden nicht gesperrt?** Richtig. Das Plugin steuert nur KI-Bots, normale Suchmaschinen folgen weiter deinen eigenen Regeln."
        },
        {
            "heading": "[Support](https://www.jtl-software.de/extension-store/nz-geo-visibility-ki-sichtbarkeit-llmstxt-mcp-und-ki-umsatz-jtl-shop-5)",
            "level": 2,
            "content": "- E-Mail: [info@nucez.de](mailto:info@nucez.de), Antwort in der Regel innerhalb eines Werktags.\n- Im Store zubuchbar: **Installationsservice** (49 €) und **Einrichtungsservice per Videocall** (129 €, max. 60 Minuten).\n\n[Mehr zu NZ GEO Visibility](https://nucez.com/projects/nz-geo-visibility)\n\nFrage zum Plugin?\n\nSchreib mir, ich antworte in der Regel innerhalb eines Werktags."
        }
    ],
    "structured_data": [
        {
            "@context": "https://schema.org",
            "@graph": [
                {
                    "@type": "ProfessionalService",
                    "@id": "https://nucez.com/#organization",
                    "name": "Nucez Software",
                    "url": "https://nucez.com/",
                    "logo": {
                        "@type": "ImageObject",
                        "url": "https://nucez.com/assets/img/email/logo-weiss.png",
                        "width": 720,
                        "height": 200
                    },
                    "image": "https://nucez.com/assets/img/og-default.jpg",
                    "email": "info@nucez.de",
                    "founder": {
                        "@id": "https://nucez.com/#person"
                    },
                    "sameAs": [
                        "https://www.google.com/maps?cid=9349361584822113195",
                        "https://www.google.com/search?kgmid=/g/11zhb0srkw",
                        "https://www.gelbeseiten.de/gsbiz/9cae0f69-e81a-4ab8-8054-ac573b388637"
                    ],
                    "openingHoursSpecification": [
                        {
                            "@type": "OpeningHoursSpecification",
                            "dayOfWeek": [
                                "Monday",
                                "Tuesday",
                                "Wednesday",
                                "Thursday",
                                "Friday"
                            ],
                            "opens": "08:00",
                            "closes": "18:00"
                        },
                        {
                            "@type": "OpeningHoursSpecification",
                            "dayOfWeek": [
                                "Saturday",
                                "Sunday"
                            ],
                            "opens": "10:00",
                            "closes": "17:00"
                        }
                    ],
                    "address": {
                        "@type": "PostalAddress",
                        "streetAddress": "Im Windfeld 36",
                        "postalCode": "32130",
                        "addressLocality": "Enger",
                        "addressRegion": "Nordrhein-Westfalen",
                        "addressCountry": "DE"
                    },
                    "areaServed": [
                        {
                            "@type": "City",
                            "name": "Enger"
                        },
                        {
                            "@type": "City",
                            "name": "Herford"
                        },
                        {
                            "@type": "City",
                            "name": "Bielefeld"
                        },
                        {
                            "@type": "AdministrativeArea",
                            "name": "Ostwestfalen-Lippe"
                        },
                        {
                            "@type": "Country",
                            "name": "Deutschland"
                        }
                    ],
                    "brand": [
                        {
                            "@type": "Brand",
                            "name": "NexoVirt",
                            "url": "https://nexovirt.com/"
                        },
                        {
                            "@type": "Brand",
                            "name": "NZ GEO Visibility",
                            "url": "https://nucez.com/projects/nz-geo-visibility"
                        }
                    ],
                    "knowsAbout": [
                        "Individualsoftware",
                        "Automatisierung",
                        "Web-Anwendungen",
                        "Webdesign",
                        "JTL-Wawi",
                        "JTL-Shop",
                        "Schnittstellen",
                        "Generative Engine Optimization",
                        "Hosting"
                    ]
                },
                {
                    "@type": "Person",
                    "@id": "https://nucez.com/#person",
                    "name": "Bjarne Fomferra",
                    "jobTitle": "Fachinformatiker für Anwendungsentwicklung",
                    "worksFor": {
                        "@id": "https://nucez.com/#organization"
                    },
                    "url": "https://nucez.com/about",
                    "image": "https://nucez.com/assets/img/portrait.jpg",
                    "address": {
                        "@type": "PostalAddress",
                        "addressLocality": "Enger",
                        "addressCountry": "DE"
                    }
                },
                {
                    "@type": "WebSite",
                    "@id": "https://nucez.com/#website",
                    "name": "Nucez Software",
                    "url": "https://nucez.com/",
                    "inLanguage": [
                        "de",
                        "en"
                    ],
                    "publisher": {
                        "@id": "https://nucez.com/#organization"
                    }
                }
            ]
        },
        {
            "@context": "https://schema.org",
            "@type": "BreadcrumbList",
            "itemListElement": [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "name": "Startseite",
                    "item": "https://nucez.com/"
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "name": "Dokumentation NZ GEO Visibility",
                    "item": "https://nucez.com/docs/nz-geo-visibility"
                }
            ]
        },
        {
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "NZ GEO Visibility für JTL-Shop 5",
            "description": "Installation, Einrichtung und Referenz für NZ GEO Visibility, das JTL-Shop-5-Plugin für KI-Sichtbarkeit, llms.txt, MCP und KI-Umsatz.",
            "inLanguage": "de",
            "author": {
                "@id": "https://nucez.com/#person"
            },
            "publisher": {
                "@id": "https://nucez.com/#organization"
            },
            "about": {
                "@type": "SoftwareApplication",
                "name": "NZ GEO Visibility",
                "applicationCategory": "BusinessApplication",
                "operatingSystem": "JTL-Shop 5.5 bis 5.8",
                "softwareVersion": "1.2.0"
            }
        }
    ],
    "publisher": {
        "name": "Nucez Software",
        "person": "Bjarne Fomferra",
        "location": "Enger, Germany",
        "email": "info@nucez.de",
        "url": "https://nucez.com/"
    }
}