Klare Antworten. Koa Schmarrn.

FAQ

Alles, was du über BreznGEO wissen wolltest — aber dein SEO-Plugin nie gefragt hast.

Erste Schritte

Brauche ich Programmierkenntnisse?

Überhaupt nicht. Installieren wie jedes WordPress-Plugin — hochladen, aktivieren, fertig. Alles wird über das Standard-WordPress-Admin konfiguriert. Kein PHP, keine Kommandozeile, keine Config-Dateien.

Was sind die Systemanforderungen?

WordPress 6.0+ und PHP 8.0+. Die meisten Hosting-Anbieter sind seit einer Weile auf PHP 8.x — das sollte kein Problem sein. Falls du unsicher bist, zeigt das Control Panel deines Hosts die PHP-Version an.

Funktioniert es mit Gutenberg und dem Classic Editor?

Beides. Die Metabeschreibungs-Meta-Box und die GEO Quick Overview Meta-Box erscheinen in beiden Editoren. BreznGEO verwendet Standard-WordPress-Meta-Boxen, die editor-agnostisch sind.

Brauche ich einen API-Key, um es zu nutzen?

Nein. BreznGEO funktioniert ohne API-Key. In diesem Fall nutzt es einen eingebauten Fallback: Es extrahiert die ersten 150–160 Zeichen aus deinem Beitragsinhalt mit satzgrenzbasierter Erkennung. Keine KI beteiligt, aber deine Beiträge bekommen immer eine Beschreibung.

Kann ich es auf mehreren Websites einsetzen?

Ja. BreznGEO ist GPL-lizenziert, du kannst es also auf beliebig vielen Websites installieren, die du besitzt oder verwaltest. Jede Website nutzt ihren eigenen API-Key und eigene Einstellungen unabhängig voneinander.

KI & Meta-Generierung

Welche KI-Anbieter werden unterstützt?

Fünf Anbieter, jederzeit umschaltbar — keine Neuinstallation nötig:

  • OpenAI (GPT-4.1, GPT-4o, GPT-4o mini)
  • Anthropic Claude (3.5 Sonnet, 3 Haiku)
  • Google Gemini (2.0 Flash, 1.5 Pro)
  • xAI Grok (3, Grok 3 mini)
  • OpenRouter — eine einzelne API, die auf 600+ Modelle inkl. Claude, GPT, Gemini, Llama, Mistral, DeepSeek und weitere weiterleitet. Details im OpenRouter-Abschnitt unten.
Was kostet die KI-Generierung tatsächlich?

Sehr wenig. Eine einzelne Metabeschreibung sind rund 150–200 Token — Bruchteile eines Cents pro Beitrag. Selbst bei der Bulk-Verarbeitung von 500 Beiträgen liegen die API-Gesamtkosten typischerweise unter 1 €. Du zahlst direkt bei deinem Anbieter; BreznGEO bekommt nichts davon.

Genaue Zahlen findest du auf der Preisseite deines Anbieters — sie variieren je nach Modell.

Überschreibt BreznGEO Metabeschreibungen, die ich selbst geschrieben habe?

Nein. Wenn ein Beitrag bereits eine Metabeschreibung hat — ob du sie geschrieben oder ein anderes Plugin sie gesetzt hat — lässt BreznGEO sie in Ruhe. Es generiert nur, wenn das Feld leer ist, es sei denn, du klickst explizit auf den Neu-Generieren-Button im Beitragseditor.

Funktioniert es neben Rank Math oder Yoast SEO?

Ja. BreznGEO erkennt automatisch Rank Math, Yoast SEO, AIOSEO und SEOPress und schreibt KI-generierte Beschreibungen direkt in deren Meta-Felder. Dein bevorzugtes SEO-Plugin behält die Kontrolle — BreznGEO füllt nur den Inhalt aus.

Was passiert, wenn der API-Aufruf fehlschlägt?

BreznGEO fällt auf seinen eingebauten Textextraktor zurück — denselben satzgrenzbasierten Fallback, der auch ohne API-Key läuft. Dein Beitrag bekommt immer eine Beschreibung, auch wenn der KI-Anbieter vorübergehend nicht verfügbar ist.

Kann ich den KI-Prompt anpassen?

Ja, vollständig. Der Prompt ist unter Einstellungen → Meta-Generator bearbeitbar. Verfügbare Platzhalter: {title}, {content}, {excerpt} und {language}. Ton, Ziellänge oder Sprache für deine Zielgruppe anpassen.

OpenRouter

Was ist OpenRouter und wann lohnt sich das?

OpenRouter ist eine einzelne API, die auf 600+ KI-Modelle weiterleitet — Claude, GPT, Gemini, Llama, Mistral, DeepSeek, Grok und viele weitere — über einen Key und ein Abrechnungskonto. Statt dich bei OpenAI, Anthropic und Google einzeln zu registrieren, zahlst du OpenRouter und wählst beliebige Modelle.

Für BreznGEO heißt das: ein Provider-Slot öffnet dir praktisch jede relevante Text-KI, Preise kommen automatisch aus der OpenRouter-API. Ideal, wenn du gerne verschiedene Modelle ausprobierst oder nur eine Rechnung statt vier möchtest.

Wie finde ich die Modell-ID für ein bestimmtes Modell?

Modell-IDs auf OpenRouter folgen dem Muster anbieter/modell-name, zum Beispiel anthropic/claude-opus-4.7, openai/gpt-4o-mini, google/gemini-2.0-flash-exp oder meta-llama/llama-3.3-70b-instruct.

Drei Wege, die genaue ID zu finden:

  1. Klicke "Modelle laden" in den Plugin-Einstellungen — die kuratierte Marketing/SEO-Auswahl wird direkt als Dropdown geladen, Preise sind bereits ausgefüllt.
  2. Besuche openrouter.ai/models, suche dein Modell und kopiere die ID unter dem Namen.
  3. Wähle "Custom model ID…" im Dropdown und füge eine beliebige ID ein — auch eine, die nicht in der kuratierten Liste steht.
Wer verarbeitet meine Inhalte eigentlich, wenn ich OpenRouter nutze?

OpenRouter ist ein Routing-Aggregator. Deine Anfrage geht zuerst an OpenRouter und wird von dort an den Upstream-Anbieter des gewählten Modells weitergeleitet — OpenAI bei einem GPT-Modell, Anthropic bei Claude, Google bei Gemini, Meta bei Llama und so weiter. Sowohl OpenRouter als auch der Upstream-Anbieter können deine Inhalte nach ihren jeweiligen Bedingungen verarbeiten.

Wenn das für deine Compliance (DSGVO, Enterprise-AVV) relevant ist, sind die direkten Anbieter-Integrationen (OpenAI, Anthropic, Gemini, Grok) besser geeignet — kürzerer Datenweg, AVV direkt mit dem Modell-Betreiber. OpenRouters Datenschutz: openrouter.ai/privacy.

Was macht der "Modelle laden"-Button?

Per Klick ruft das Plugin die kuratierte "marketing"-Kategorie von openrouter.ai/api/v1/models ab und cacht das Ergebnis für 12 Stunden. Damit wird das Modell-Dropdown gefüllt und Input-/Output-Preise pro 1 Mio. Token werden automatisch übernommen. Bei dieser Abfrage werden keine Inhalte von dir gesendet — es ist reiner Katalog-Abruf.

Der Abruf ist bewusst opt-in: Ohne Button-Klick fließt nichts zu OpenRouter. Das hält das Plugin WordPress.org-konform und respektiert Nutzer, die ausgehende Requests minimieren wollen.

Warum sind die OpenRouter-Preise nur lesbar?

Weil Preise bei OpenRouter häufig wechseln (neue Modelle, Rabatte, Routing-Änderungen) und bereits über die API veröffentlicht sind. Manuelle Eingabe würde nur zu veralteten Werten und falschen Schätzungen einladen. BreznGEO zeigt die aktuellen Preise aus OpenRouters eigenen Daten, damit die Bulk-Kostenschätzung im Generator ehrlich bleibt.

Bei einer Custom-Modell-ID, die nicht in der gecachten Liste steht, wird der Preis als "Unbekannt" angezeigt, bis du Modelle neu lädst. Die Generierung funktioniert trotzdem — nur die Kostenschätzung fehlt.

GEO Quick Overview

Was ist "GEO" und warum sollte mich das interessieren?

GEO steht für Generative Engine Optimization — die Praxis, deine Inhalte so zu strukturieren, dass KI-Systeme wie ChatGPT, Perplexity und Claude sie lesen, verstehen und akkurat zitieren können.

Klassisches SEO zielt auf Suchmaschinen-Crawler. GEO zielt auf die KI-Modelle, die zunehmend die Suche als ersten Kontaktpunkt zwischen Lesern und Inhalten ersetzen.

Was genau generiert der GEO Quick Overview Block?

Drei Dinge: eine kurze Zusammenfassung deines Beitrags, eine Aufzählung der wichtigsten Punkte und einen optionalen FAQ-Bereich — alles aus deinem Beitragsinhalt generiert. Er erscheint in deinem Beitrag als aufklappbares <details>-Element. Vollständig bearbeitbar, kein JavaScript im Frontend nötig.

Verlangsamt der GEO-Block meine Website?

Nein. Der Block gibt reines HTML aus — ein natives <details>-Element mit statischem Text. Kein JavaScript wird im Frontend geladen. Er ist genauso schnell wie ein normaler Absatz.

Was ist die Auto-Lock-Funktion?

Wenn du die KI-generierte Zusammenfassung, die Bullet Points oder das FAQ im Beitragseditor manuell bearbeitest, sperrt BreznGEO diesen Beitrag automatisch. Beim nächsten Speichern oder Veröffentlichen überschreibt die KI deine Änderungen nicht. Du kannst die Sperre jederzeit manuell in der Meta-Box aufheben.

Erscheint der GEO-Block automatisch in jedem Beitrag?

Standardmäßig ja — bei jedem Beitrag, der den Wortzahl-Schwellenwert erfüllt (Standard: 350 Wörter). Du kannst ihn pro Beitrag über die Meta-Box im Editor deaktivieren oder den Generierungsmodus in den globalen Einstellungen auf "nur manuell" umschalten.

Keyword-Analyse

Was prüft die Keyword-Analyse?

Zehn On-Page-SEO-Faktoren: ob dein Fokus-Keyword im Titel, in Überschriften (H2–H6), im URL-Slug, im ersten Absatz, im letzten Absatz, in der Metabeschreibung, im Bild-Alt-Text, im Bild-Titel/Caption und im Auszug vorkommt — plus Keyword-Dichte gegen einen konfigurierbaren Zielbereich.

Brauche ich einen KI-Key für die Keyword-Analyse?

Nein. Alle zehn Checks laufen lokal ohne API-Key. Die optionalen KI-Features — Keyword-Vorschläge, Content-Optimierungstipps und semantische Keyword-Analyse — erfordern einen konfigurierten API-Key und werden manuell aus der Meta-Box ausgelöst.

Was sind Primär- und Sekundär-Keywords?

Das Primär-Keyword ist dein Haupt-Fokus-Begriff — es wird gegen alle zehn Faktoren mit strengeren Schwellenwerten geprüft. Sekundär-Keywords sind unterstützende Begriffe (du kannst mehrere hinzufügen); sie verwenden gelockerte Mindestvorkommen. Beide werden pro Beitrag gespeichert und in die Analyse einbezogen.

Was bedeutet „sprachbasierte Variantenerkennung“?

BreznGEO generiert automatisch Varianten deines Keywords basierend auf der Sprache deiner Website. Für Deutsch: -er, -en, -e. Für Englisch: Trailing-s, -es, -ing, -ed. Es erkennt auch Compound-Formen (Leerzeichen vs. Bindestriche). Wenn dein Keyword „Keyword Analyse“ ist, findet es auch „Keyword-Analyse“ und „Keyword Analysen“.

Was sind die drei Update-Modi?

Live — die Analyse läuft automatisch beim Tippen mit konfigurierbarem Debounce-Delay (Standard 800ms). Manuell — du klickst den „Analysieren“-Button wenn du bereit bist. Beim Speichern — die Analyse läuft beim Speichern oder Veröffentlichen des Beitrags. Wähle deinen bevorzugten Modus unter BreznGEO → Keywords.

Schema & Strukturierte Daten

Was sind strukturierte Daten und warum sind sie wichtig?

Strukturierte Daten (Schema.org JSON-LD) sind maschinenlesbare Metadaten, die unsichtbar in deine Seite eingebettet werden. Google nutzt sie für Rich Results — Sternbewertungen, Rezeptkarten, FAQ-Dropdowns in der Suche. KI-Systeme nutzen sie, um Kontext, Autorenschaft und Inhaltstyp zu verstehen. Für Leser unsichtbar, für Algorithmen sehr sichtbar.

Welche Schema-Typen unterstützt BreznGEO?

14 Typen: Organization, Article / BlogPosting, Author (Person), ImageObject, VideoObject (automatisch aus YouTube/Vimeo-Einbettungen erkannt), FAQPage (automatisch aus GEO-Block-Daten generiert), Speakable, BreadcrumbList, HowTo, Review, Recipe und Event. Jeder Typ kann unabhängig aktiviert oder deaktiviert werden.

Kollidiert BreznGEOs Schema mit Rank Math oder Yoast?

Nein. BreznGEO erkennt aktive SEO-Plugins und unterdrückt automatisch die BreadcrumbList-Ausgabe, wenn Rank Math oder Yoast aktiv ist — da diese den Typ bereits ausgeben. Andere Schema-Typen von BreznGEO ergänzen die Ausgabe dieser Plugins, ohne sie zu duplizieren.

Muss ich Schema-Daten für jeden Beitrag manuell ausfüllen?

Für die automatischen Typen (Organization, BlogPosting, BreadcrumbList, Author) — nein. Sie ziehen automatisch Daten aus deinen Website-Einstellungen und Post-Meta.

Für beitragsspezifische Typen (Recipe, HowTo, Review, Event) — ja, einmalig pro Beitrag über die BreznGEO Schema Meta-Box im Beitragseditor. Sie erscheint nur, wenn mindestens einer dieser Typen in den Einstellungen aktiviert ist.

Kompatibilität

Funktioniert BreznGEO mit WooCommerce?

BreznGEO konzentriert sich auf Beiträge und Seiten. Für WooCommerce-Produkte werden keine Metabeschreibungen oder Schema-Daten generiert. Wenn du Produkt-SEO brauchst, nutze ein dediziertes WooCommerce-SEO-Plugin neben BreznGEO — es gibt keine Konflikte.

Funktioniert es auf WordPress Multisite?

BreznGEO kann netzwerkweit auf einer Multisite-Installation aktiviert werden, aber die Einstellungen gelten pro Website. Jede Website im Netzwerk verwaltet ihren eigenen API-Key, die Anbieterauswahl und Konfiguration unabhängig.

Ist es kompatibel mit Caching-Plugins wie WP Rocket oder W3 Total Cache?

Ja. BreznGEO generiert Meta-Tags und JSON-LD im <head> serverseitig zum Zeitpunkt des Requests. Es gibt nichts im Frontend, womit Caching interferieren würde. Caching-Plugins cachen einfach die Ausgabe, was genau das beabsichtigte Verhalten ist.

Funktioniert es mit Elementor, Divi oder anderen Page Buildern?

Ja. BreznGEO hängt sich auf WordPress-Ebene in Beitragsspeicher- und Veröffentlichungs-Events ein, unabhängig davon, welcher Editor oder Builder zum Erstellen des Inhalts verwendet wurde. Metabeschreibungen und Schema sind an das Beitragsobjekt gebunden, nicht an die Inhaltsstruktur des Builders.

Funktioniert es mit ClassicPress?

Ja. BreznGEO wurde vollständig auf ClassicPress getestet und ist 100% kompatibel. Alle Features funktionieren — KI-Metabeschreibungen, GEO-Blöcke, Schema.org, llms.txt, robots.txt-Verwaltung, Crawler-Log, interne Linkvorschläge, Keyword-Analyse und die gesamte Admin-Oberfläche inklusive deutscher Übersetzung. Da BreznGEO ausschließlich Classic-Editor-Metaboxen verwendet (keine Gutenberg-Blöcke), passt es perfekt zu ClassicPress.

Sicherheit & Datenschutz

Wo werden meine API-Keys gespeichert?

API-Keys werden mit XOR verschlüsselt — der Schlüssel wird aus deinen WordPress-Auth-Salts abgeleitet — bevor sie in die Datenbank geschrieben werden. Die Salts sind pro Installation einzigartig, sodass der verschlüsselte Wert außerhalb deiner Website nutzlos ist. Keys werden nie im Klartext gespeichert und tauchen nie in Logs auf.

Sendet BreznGEO meinen Beitragsinhalt an Dritte?

Nur an den KI-Anbieter, den du konfiguriert hast — und nur wenn du eine Generierung auslöst. Titel und Inhalt deines Beitrags werden als Teil des Prompts an OpenAI, Anthropic, Google oder xAI gesendet, je nachdem, wen du gewählt hast.

Es werden keine Daten an BreznGEO, Donau2Space.de oder einen Dritten jenseits deines gewählten KI-Anbieters gesendet. Die Standard-Datenverarbeitungsbedingungen deines Anbieters gelten.

Sammelt BreznGEO Daten über meine Besucher?

Der Crawler-Log zeichnet Besuche bekannter KI-Bots auf (GPTBot, ClaudeBot usw.). Gespeichert werden: der Bot-Name, ein SHA-256-Hash der IP-Adresse (die Original-IP wird nie gespeichert und kann nicht wiederhergestellt werden), die besuchte URL und der Zeitstempel. Einträge werden nach 90 Tagen automatisch gelöscht. Daten menschlicher Besucher werden nie erfasst.

Ist BreznGEO DSGVO-konform?

BreznGEO selbst erhebt keine personenbezogenen Daten. Der Crawler-Log speichert nur gehashte IPs — nicht auf echte Adressen zurückführbar. Der Auftragsverarbeitungsvertrag deines KI-Anbieters deckt den zur Generierung gesendeten Inhalt ab. Übliche Praxis ist, deinen KI-Anbieter in der Datenschutzerklärung deiner Website zu nennen.

Lizenz & Zukunft

Ist es wirklich kostenlos? Was ist der Haken?

Kein Haken. BreznGEO ist GPL-2.0 lizenziert und kostenlos nutzbar. Die einzigen Kosten sind deine KI-API-Nutzung, direkt von deinem Anbieter abgerechnet. Es gibt kein Freemium-Modell, keine Feature-Beschränkung, keinen Premium-Tier und keine Upselling-E-Mails. Prost.

Bleibt es kostenlos?

Das ist die Absicht. BreznGEO wurde gebaut, weil ich für meinen eigenen Blog keine monatliche SaaS-Gebühr zahlen wollte. Diese Motivation hat sich nicht geändert. Wenn neue Features hinzukommen, kommen sie ins kostenlose Plugin — nicht hinter eine Bezahlschranke.

Kann ich es auf Kunden-Websites einsetzen?

Ja. GPL-2.0 erlaubt die Installation auf beliebig vielen Websites. Es gibt keine Lizenzprüfungen, Aktivierungslimits oder Gebühren pro Website. Jede Kunden-Website braucht ihren eigenen API-Key beim Anbieter ihrer Wahl.

Wird es je eine Pro-Version geben?

Derzeit keine Pläne für einen bezahlten Tier. Das Modell ist einfach: BreznGEO bleibt kostenlos, du zahlst direkt bei deinem KI-Anbieter. Das war's.

Wo kann ich Bugs melden oder Features anfragen?

Öffne ein Issue auf github.com, nutze das WordPress.org-Support-Forum.