KI-Funktionen

WP-ImmoMakler kann auf Basis der vorhandenen Immobiliendaten und Beschreibungstexte automatisch suchmaschinenoptimierte Inhalte erzeugen. Konfiguriert wird die Funktion im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Integrationen → KI-Funktionen. Die KI-Anbindung selbst läuft seit WordPress 7.0 zentral über die WordPress-Konnektoren. PLUS

KI-Anbieter anbinden

WP-ImmoMakler nutzt den WordPress AI Client — eine standardisierte Schnittstelle in WordPress, über die verschiedene KI-Anbieter angebunden werden können, ohne sich auf einen bestimmten Dienst festzulegen.

Unterstützte Anbieter

Standardmäßig stehen folgende Anbieter im WordPress-Core zur Verfügung:

• Anthropic Claude
• Google Gemini
• OpenAI ChatGPT

Sie können einen oder mehrere Anbieter gleichzeitig konfigurieren. WP-ImmoMakler wählt automatisch ein passendes Modell aus den hinterlegten Anbietern.

API-Schlüssel hinterlegen

Navigieren Sie im Backend Ihrer Website (wp-admin) zu Einstellungen → Konnektoren und hinterlegen Sie den API-Schlüssel des gewünschten Anbieters. Die Zugangsdaten werden zentral in WordPress gespeichert und stehen allen Plugins zur Verfügung, die den WordPress AI Client unterstützen.

Eine ausführliche Schritt-für-Schritt-Anleitung — wie Sie einen Konnektor anlegen und bei Anthropic Claude, Google Gemini und OpenAI ChatGPT jeweils einen API-Schlüssel erstellen — finden Sie unter KI-Konnektoren einrichten.

WordPress-Versionen und KI-Anbindung

Vor WordPress 7.0 lieferte WP-ImmoMakler den WP AI Client als mit dem Plugin gebündelte Bibliothek aus, und die API-Schlüssel wurden in plugin-eigenen Optionen abgelegt. Mit WordPress 7.0 sind der AI Client und die neuen Konnektoren Teil des WordPress-Cores. Die Verwaltung der KI-Zugangsdaten erfolgt seitdem zentral unter Einstellungen → Konnektoren.

Beim Update auf WordPress 7.0: API-Schlüssel neu hinterlegen

WordPress 7.0 übernimmt keine API-Schlüssel aus den bisherigen Speicherorten der WordPress-Versionen 6.8 und 6.9. Nach dem Update auf WordPress 7.0 erscheint deshalb auf der Integrationen-Seite ein gelber, schließbarer Hinweis „KI-Funktionen aktiviert, aber kein KI-Anbieter angebunden”, und der WP-ImmoMakler-Menüpunkt zeigt einen roten Status-Punkt — obwohl die KI in WP-ImmoMakler vorher genutzt werden konnte.

Hinterlegen Sie Ihren API-Schlüssel einmalig neu unter Einstellungen → Konnektoren. Anschließend funktionieren die KI-Funktionen in WP-ImmoMakler ohne weitere Anpassungen.

Einstellungen in WP-ImmoMakler

Welche Texte automatisch generiert werden und wie die Prompts formuliert sind, legen Sie im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Integrationen → KI-Funktionen fest.

Nutzung Künstlicher Intelligenz aktivieren

Globaler Hauptschalter für alle KI-Funktionen. Solange dieser Schalter deaktiviert ist, werden weder SEO-Texte noch Excerpts generiert — auch wenn die einzelnen Funktionen darunter aktiviert sind.

Ist der Schalter aktiv, prüft WP-ImmoMakler, ob unter Einstellungen → Konnektoren ein KI-Anbieter mit Zugangsdaten verbunden ist. Fehlt die Anbindung, erscheinen zwei Hinweise:

• ein roter Status-Punkt am Menüpunkt WP-ImmoMakler in der seitlichen Admin-Navigation,
• ein gelbes, schließbares Hinweis-Banner mit dem Titel „KI-Funktionen aktiviert, aber kein KI-Anbieter angebunden” oberhalb der Integrationen-Einstellungen.

Beide verlinken direkt zur Konnektoren-Seite, damit Sie die Anbindung schnell nachholen können.

Hinweis

Die Nutzung Künstlicher Intelligenz kann unvorhersehbare Ergebnisse erzeugen. Wir empfehlen, generierte Texte gelegentlich stichprobenartig zu prüfen.

SEO-Title

Der SEO-Title wird als <title>-Tag im HTML-Kopf ausgegeben und erscheint als erster Text in den Suchergebnissen. Er dient außerdem als og:title-Wert für Social-Media-Vorschauen, sofern ein kompatibles SEO-Plugin (z. B. Yoast SEO oder Rank Math) installiert ist.

Folgende Optionen stehen zur Verfügung:

• SEO-Title generieren — Aktiviert die Generierung. Bei aktiver Option wird der SEO-Title KI-generiert aus den Objektangaben und Beschreibungstexten.
• SEO-Title: Prompt — Der Anweisungstext für die KI. Der Prompt kann in einer beliebigen Sprache formuliert werden; die generierten Texte erscheinen unabhängig davon in der Sprache der jeweiligen Immobilie.
• SEO-Title: Preisangaben einbeziehen — Wenn aktiviert, werden Preisangaben in den Prompt einbezogen. Standard: deaktiviert. Beachten Sie, dass Preisangaben in Google-Suchergebnissen erscheinen können und auch nach Änderung oder Löschung der Immobilie für längere Zeit dort verbleiben können.
• SEO-Title: max. Zeichenanzahl — Maximale Länge des generierten Titels. Standard: 60 Zeichen, erlaubt sind 10 bis 500.

SEO-Description

Die SEO-Description wird als <meta name="description"> im HTML-Kopf ausgegeben. Sie erscheint in Google-Suchergebnissen unterhalb des Titels und beeinflusst maßgeblich die Klickrate. Kompatible SEO-Plugins übernehmen die generierte Beschreibung automatisch.

Solange die KI noch nicht geantwortet hat, wird der Text ausgeliefert, den WP-ImmoMakler beim Import aus seinen Vorlagen erzeugt hat; die KI-Fassung ersetzt ihn anschließend. Sind die KI-Funktionen ausgeschaltet, bleibt es bei den Texten aus den Vorlagen – siehe SEO-Titel und SEO-Description.

Bei Referenzen – bereits verkauften oder vermieteten Objekten – erhält die KI zusätzlich den Hinweis, dass das Objekt nicht mehr verfügbar ist. Sie bietet es dann nicht mehr an und spricht stattdessen verkaufsbereite Eigentümer an. Dieser Hinweis wird an jeden Prompt angehängt und lässt sich nicht überschreiben.

Folgende Optionen stehen zur Verfügung:

• SEO-Description generieren — Aktiviert die Generierung.
• SEO-Description: Prompt — Der Anweisungstext für die KI. Sprache des Prompts ist beliebig wählbar.
• SEO-Description: Preisangaben einbeziehen — Standard: deaktiviert.
• SEO-Description: max. Zeichenanzahl — Standard: 160 Zeichen, erlaubt sind 10 bis 500.

Excerpt

Der Excerpt ist eine kompakte Zusammenfassung der wichtigsten Objektmerkmale. Er wird im WordPress-Standardfeld post_excerpt gespeichert und ist an folgenden Stellen verwendbar:

• Detailseite (Einzelansicht) — als hervorgehobener Lead-Absatz unter dem Untertitel (standardmäßig aktiv, siehe Anzeige auf der Detailseite)
• Strukturierte Daten (JSON-LD) — als disambiguatingDescription der Immobilie, getrennt von der SEO-Description
• Eigene Templates über die WordPress-Funktionen get_the_excerpt() und the_excerpt()
• Page Builder wie Elementor, Divi oder Beaver Builder
• Suchergebnisseiten und Listenansichten als Teasertext
• REST-API-Endpunkte

Folgende Optionen stehen zur Verfügung:

• Excerpt generieren — Aktiviert die Generierung.
• Excerpt: Prompt — Der Anweisungstext für die KI.
• Excerpt: Preisangaben einbeziehen — Standard: deaktiviert.
• Excerpt: max. Zeichenanzahl — Standard: 300 Zeichen, erlaubt sind 10 bis 2000.

Anzeige auf der Detailseite

Unabhängig davon, ob der Text manuell gepflegt oder per KI erzeugt wurde, zeigt WP-ImmoMakler das Excerpt auf der Immobilien-Detailseite standardmäßig als hervorgehobene Zusammenfassung direkt unter dem Untertitel an (CSS-Klasse immomakler-property-excerpt). Ist für eine Immobilie kein Excerpt hinterlegt, wird der Absatz nicht ausgegeben.

Die Anzeige lässt sich an zwei Stellen steuern:

• Customizer: im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Customizer → Immobilien Detailansicht → Zusammenfassung anzeigen — schaltet den Absatz für die Standard-Detailansicht ein oder aus.
• Page Builder: Die Builder-Elemente „Detailansicht (komplett)” für Elementor, WPBakery, Divi, Bricks und Oxygen sowie der Gutenberg-Block „Immobilien Detailansicht” besitzen je eine eigene Option Zusammenfassung anzeigen, mit der Sie die Ausgabe pro Template übersteuern.

Zusätzlich wird das Excerpt in den strukturierten Daten (JSON-LD) der Immobilie als disambiguatingDescription ausgegeben — getrennt von der description (SEO-Description). So erhalten Suchmaschinen und KI-Antwortsysteme (AEO/GEO) eine kompakte, eigenständige Kurzfassung des Objekts. Details zur Schema.org-Ausgabe finden Sie unter Schema.org / strukturierte Daten.

Standard-Prompts zurücksetzen

Direkt über dem Speichern-Button steht das Auswahlfeld Standard-Prompts zurücksetzen. Wählen Sie hier eine Sprache (Deutsch, Englisch, Spanisch oder Französisch), werden alle drei Prompt-Felder (SEO-Title, SEO-Description, Excerpt) sofort auf die mitgelieferten Standard-Prompts in der gewählten Sprache zurückgesetzt. Anschließend springt die Auswahl zurück auf „— Bitte wählen —”.

Eigene Anpassungen werden dabei überschrieben. Sichern Sie wichtige Anpassungen vorher oder nutzen Sie die Funktion bewusst, um wieder mit einer sauberen Vorlage zu starten.

Die mitgelieferten Standard-Prompts sind in informellem Stil verfasst (Du/tú/tu), wie es bei Prompts an Sprachmodelle üblich ist. Die hier gewählte Sprache hat keinen Einfluss auf die Sprache der von der KI generierten Texte — diese ergibt sich automatisch aus den Eigenschaften der jeweiligen Immobilie.

Wann die Texte entstehen

Die KI-Texte entstehen nicht während des Imports, sondern kurz danach im Hintergrund. Sobald eine Immobilie importiert und veröffentlicht ist, merkt sich WP-ImmoMakler, welche der drei Texte noch fehlen, und ein Hintergrundprozess arbeitet diese Warteschlange ab. Der Import wartet dadurch nicht mehr auf den KI-Anbieter und läuft auch dann zügig durch, wenn dieser langsam antwortet oder gerade nicht erreichbar ist.

Bis die KI-Texte vorliegen, ist die Immobilie nicht etwa textlos: WP-ImmoMakler erzeugt SEO-Title, SEO-Description und Excerpt beim Import zunächst aus den Objektdaten selbst — also aus Objektart, Ort, Fläche und Zimmerzahl. Diese Standard-Texte werden ersetzt, sobald die KI geantwortet hat.

Zeitlicher Ablauf

Der Hintergrundprozess läuft alle fünf Minuten und nimmt sich dabei bis zu fünf Immobilien vor. Da pro Immobilie bis zu drei Texte erzeugt werden, sind das höchstens 15 Anfragen an Ihren KI-Anbieter je Durchlauf. Nach einem Vollabgleich mit mehreren hundert Immobilien dauert es entsprechend einige Zeit, bis alle Texte vorliegen — die Warteschlange bleibt dabei erhalten und wird Schritt für Schritt abgearbeitet.

Der Hintergrundprozess ist ein WordPress-Cron-Ereignis und braucht deshalb — wie der automatische Import — regelmäßige Aufrufe Ihrer Website. Auf Websites mit wenig Besucherverkehr richten Sie dafür am besten einen echten Cronjob ein; wie das geht, steht unter Automatischer Import per Cronjob.

KI-Texte für vorhandene Immobilien neu erzeugen

In die Warteschlange kommt eine Immobilie von allein nur beim Import. Für Immobilien, die bereits in WordPress liegen, gibt es drei Auslöser:

• Einzelne Immobilie — im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Immobilien erscheint in der Zeile der Immobilie die Aktion KI-Texte neu erzeugen.
• Auswahl — markieren Sie mehrere Immobilien und wählen Sie oberhalb der Liste unter Mehrfachaktionen den Eintrag KI-Texte neu erzeugen.
• Alle Immobilien — im Tab KI-Funktionen liegt unter den Prompt-Einstellungen der Button KI-Texte für alle Immobilien neu erzeugen.

Kein Klick erzeugt dabei selbst Text: Er setzt die Immobilie lediglich in die Warteschlange, die der Hintergrundprozess anschließend abarbeitet. Deshalb kann ein Klick auch nicht am KI-Anbieter hängen bleiben, und Sie können sofort weiterarbeiten.

Der Bestand wird ebenfalls schrittweise eingeplant — 50 Immobilien je Durchlauf des Hintergrundprozesses, damit auch eine Website mit mehreren tausend Immobilien nicht an einer einzigen Anfrage hängt. Solange der Durchlauf läuft, zeigt der Tab statt des Buttons den Hinweis, dass bereits ein Durchlauf läuft, sowie den Button Durchlauf abbrechen. Ein Abbruch stoppt nur das weitere Einplanen; bereits eingeplante Immobilien behalten ihren Platz in der Warteschlange. Wie viele Immobilien gerade warten, steht ebenfalls im Tab.

Die drei Aktionen erscheinen nur, wenn mindestens einer der drei Texte eingeschaltet ist und Ihr Benutzerkonto Immobilien verwalten darf (Berechtigung manage_immomakler_properties).

Typische Anlässe: Sie haben oben einen Prompt geändert und möchten ihn auf den Bestand anwenden, oder Sie haben die KI-Funktionen erst eingeschaltet, als die Immobilien längst in WordPress lagen.

Wenn der KI-Anbieter nicht antwortet

• Anfragelimit erreicht (Rate Limit oder aufgebrauchtes Kontingent): WP-ImmoMakler pausiert daraufhin alle KI-Anfragen. Nennt der Anbieter eine Wartezeit, wird diese übernommen, sonst wird fünf Minuten pausiert; länger als eine Stunde wird nie pausiert. Anschließend läuft die Warteschlange weiter. Das gilt der Immobilie nicht als Fehlversuch.
• Kein KI-Anbieter angebunden: Die Warteschlange bleibt bestehen und wird eine Stunde später erneut geprüft. Sobald Sie unter Einstellungen → Konnektoren einen API-Schlüssel hinterlegt haben, werden die Texte nachgeholt.
• Einzelner Fehler bei einer Immobilie: Nur diese Immobilie wird zurückgestellt und mit wachsendem Abstand erneut versucht. Nach fünf erfolglosen Versuchen nimmt WP-ImmoMakler sie aus der Warteschlange; beim nächsten Import dieser Immobilie beginnt der Vorgang von vorn.

Was der Hintergrundprozess tut, hält WP-ImmoMakler in einer Log-Datei immomakler-ai-… im Import-Verzeichnis fest — getrennt vom Import-Protokoll, damit Anbieter-Timeouts und Wiederholungen dieses nicht überlagern.

Auswirkung auf das PDF-Exposé PLUS

Das PDF-Exposé übernimmt SEO-Title und SEO-Description in seine Dokumenteigenschaften. Ein beim Veröffentlichen vorgeladenes PDF enthält deshalb zunächst die Standard-Texte. WP-ImmoMakler verwirft es daher, sobald die KI-Texte einer Immobilie geschrieben sind, und erzeugt es neu.

Profi-Tipp

Der Ablauf lässt sich per Code anpassen:

// Wie oft der Hintergrundprozess läuft, in Sekunden (Standard: 300, Minimum: 60).
add_filter( 'immomakler_ai_worker_interval', fn (): int => 900 );

// Wie viele Immobilien ein Durchlauf bearbeitet (Standard: 5).
// Bei einem knappen Anbieter-Kontingent kleiner setzen.
add_filter( 'immomakler_ai_worker_batch_size', fn (): int => 2 );

// Welche Texte für eine Immobilie in die Warteschlange kommen.
// Ein leeres Array überspringt die Immobilie ganz - hier: Referenzobjekte.
add_filter(
  'immomakler_ai_queued_fields',
  function ( array $fields, int $post_id ): array {
    return \ImmoMakler\Data\Property_Helper::is_reference( $post_id ) ? [] : $fields;
  },
  10,
  2
);

// Läuft, sobald die KI-Texte einer Immobilie geschrieben sind.
add_action( 'immomakler_ai_texts_generated', function ( int $post_id ): void {
  // z. B. einen externen Cache für diese Immobilie leeren.
} );

Häufige Fragen

Werden bestehende Texte nach einer Prompt-Änderung neu erzeugt? Nein. Ein geänderter Prompt gilt für alle Texte, die danach erzeugt werden; bereits vorhandene Texte bleiben stehen. In die Warteschlange kommt eine Immobilie, wenn sie neu importiert oder per Update-Import aktualisiert wird — eine Prompt-Änderung wirkt sich deshalb erst beim nächsten Import einer Immobilie aus.

Um Texte für alle bestehenden Immobilien neu erzeugen zu lassen, nutzen Sie den Button KI-Texte für alle Immobilien neu erzeugen im Tab KI-Funktionen — siehe KI-Texte für vorhandene Immobilien neu erzeugen. Ein Vollabgleich in Ihrer Maklersoftware führt zum selben Ergebnis, überträgt dabei aber sämtliche Immobiliendaten neu.

Warum steht bei einer frisch importierten Immobilie zunächst ein anderer Text? Weil die KI-Texte erst kurz nach dem Import im Hintergrund entstehen. Bis dahin zeigt die Immobilie die Standard-Texte, die WP-ImmoMakler aus den Objektdaten selbst zusammensetzt. Näheres unter Wann die Texte entstehen.

Welche Daten nutzt die KI? Das System wertet alle eingetragenen Objektdaten aus — Lage, Typ, Fläche, Zimmerzahl, Ausstattung — sowie manuell erfasste Beschreibungen. Preisangaben werden nur einbezogen, wenn die jeweilige Option pro SEO-Title, SEO-Description oder Excerpt explizit aktiviert wurde. Je vollständiger die Daten, desto besser die generierten Texte.

Sind SEO-Kenntnisse erforderlich? Nein. Die KI übernimmt die Optimierung automatisch. Es empfiehlt sich dennoch, die generierten Texte gelegentlich zu prüfen und an die eigene Unternehmenssprache anzupassen.

In welcher Sprache wird der Prompt geliefert? Standardmäßig in Deutsch. Über das Auswahlfeld Standard-Prompts zurücksetzen am Ende des Tabs wechseln Sie jederzeit zu Englisch, Spanisch oder Französisch und laden die jeweilige Vorlage in alle drei Prompt-Felder. Den geladenen Prompt können Sie anschließend frei anpassen. Die Sprache des Prompts beeinflusst nicht die Sprache der generierten Texte — diese wird per Immobilie automatisch festgelegt.

---

Das könnte Sie auch interessieren

• KI-Konnektoren einrichten
• SEO-Titel und SEO-Description
• Schema.org / strukturierte Daten
• Google-Indexierung
• Yoast SEO Integration
• Rank Math Integration