Bodenrichtwerte in n8n-Workflows nutzen

Eine Makleragentur, die 200 Leads im Monat durchs CRM laufen lässt, hat ein Bodenrichtwert-Problem, das sich mit einzelnen Abfragen nicht löst: Niemand nimmt sich für jeden neuen Kontakt zwei Minuten Zeit, um den Wert manuell nachzuschlagen — also bleibt das Feld leer, bis im besten Fall jemand im Kundengespräch danach fragt. Wenn neue Adressen ohnehin durch eine Automatisierung laufen — neuer CRM-Kontakt, neue Zeile im Sheet, neues Objekt im Pipeline-Tool —, holst du den Bodenrichtwert stattdessen im selben Schritt automatisch dazu. Dieser Artikel zeigt das Muster in n8n samt der Design-Entscheidungen dahinter; die Klick-für-Klick-Variante steht im Cookbook.

Was du baust

Einen Workflow, der zu einer eingehenden Adresse den amtlichen Bodenrichtwert abruft und das Ergebnis in dein Zielsystem schreibt. Typisches Szenario:

Neuer Kontakt im CRM → Workflow holt Bodenrichtwert → CRM-Feld wird befüllt.

n8n ist ein visueller Workflow-Baukasten (self-hosted oder über n8n.cloud). Dieser Artikel setzt Grundkenntnisse voraus.

Warum Webhook, nicht Polling

Zwei Muster wären denkbar: Der Workflow fragt in festen Abständen alle neuen Einträge ab (Polling), oder das Quellsystem meldet sich selbst, sobald ein neuer Datensatz entsteht (Webhook). Für den Bodenrichtwert-Lookup ist Webhook fast immer die richtige Wahl. Polling bedeutet entweder Verzögerung (alle 15 Minuten prüfen — der Wert steht erst mit Verspätung im CRM) oder unnötige Last (jede Minute prüfen, obwohl sich meistens nichts ändert). Ein Webhook reagiert sofort und nur dann, wenn wirklich ein neuer Kontakt da ist. Bei einem gedeckelten Monats-Kontingent zählt jede unnötige Abfrage — Polling verbrennt Kontingent, ohne neue Werte zu liefern.

Voraussetzungen

Ein n8n-Workspace (n8n.cloud oder self-hosted)
Ein (kostenlos starten)
Ein API-Key aus deinem Dashboard — der Schlüssel, mit dem n8n in deinem Namen abfragt. Sicher ablegen, er ist nur einmal sichtbar.

Das Muster

1. Webhook-Node (Trigger). Einstiegspunkt des Workflows — startet z. B., wenn dein CRM einen neuen Kontakt meldet. Die Adresse kommt im Payload.

2. HTTP-Request-Node (GET). Die eigentliche Abfrage. URL mit der Adresse aus dem Payload:

https://api.bodenrichtwert.ai/api/bodenrichtwert?address={{$json.address}}

Behandle den &nutzungsart=-Parameter als Pflicht-Mapping-Schritt, nicht als optionalen Zusatz: Ohne explizite Nutzungsart liefert die Abfrage bei Adressen mit mehreren überlappenden Zonen (z. B. Wohn- und Gewerbezone im selben Straßenzug) mehrdeutige oder unerwartete Ergebnisse. Mappe sie im Workflow verbindlich aus deinem Quellsystem, z. B. &nutzungsart=W für Wohnen aus dem Objekttyp im CRM. Welcher Code wann passt: Nutzungsarten erklärt.

3. Authentifizierung per Header. Im HTTP-Node unter Authentication → Generic Credential Type → Header Auth:

Name:  Authorization
Value: Bearer DEIN_API_KEY

4. Ergebnis weiterreichen. An einen CRM-, Sheet- oder Airtable-Node und die Felder mappen: brw_euro_pro_m2, stichtag, gutachterausschuss und das attribution-Objekt.

Attribution mit-speichern: Die Datenlizenz dl-de/by-2-0 verlangt die Namensnennung der Quelle. Schreib das attribution-Feld mit in dein Zielsystem (oder zeig es dort an), wo der Wert weiterverwendet wird — nicht nur die nackte Zahl.

Den 451-Fall einplanen

Adressen in Schleswig-Holstein, Sachsen und Bayern beantwortet die API mit HTTP 451. In n8n läuft der HTTP-Node sonst auf einen Fehler — setze „Continue On Fail" und verzweige auf den Statuscode, damit der Workflow für diese Adressen sauber weiterläuft, statt abzubrechen. Design-Entscheidung dabei: nicht einfach leer lassen. Schreib im 451-Zweig einen expliziten Hinweistext ins Zielfeld („Bodenrichtwert für dieses Bundesland aktuell nicht verfügbar") statt eines stillen Blanks — sonst ist im CRM später nicht mehr zu unterscheiden, ob der Lookup fehlgeschlagen ist oder schlicht nie lief.

Testen

Trigger den Webhook mit einer Test-Adresse wie Domkloster 4, 50667 Köln. Im Output des HTTP-Nodes erscheint der amtliche Bodenrichtwert. Steht dort 401 Unauthorized, ist der API-Key falsch oder nicht korrekt im Header gesetzt.

Mehr Rezepte

Für andere Tools gibt es fertige Cookbook-Rezepte: Zapier/Make, Python/pandas, Excel/Power Query, LangChain. Geht es um KI-Agenten statt klassische Automation, ist der MCP-Server der direktere Weg.

Workflow bauen: Account + API-Key holen — die ersten Abfragen sind im 14-Tage-Trial frei. Für produktive Automationen lohnt sich Pro oder Enterprise.