n8n
Firmendaten in Workflows, ohne Code.
Mit dem Node für n8n holst du Firmendaten in deine Workflows, ohne Code. Der Node ist von n8n verifiziert und ruft dieselbe API auf wie deine eigene Software.
Node installieren
Verifizierte Nodes installierst du direkt aus dem Editor. Das darf nur der Owner oder ein Admin der n8n-Instanz; danach nutzen alle Mitglieder den Node.
- Öffne einen Workflow und klicke auf „+“, um das Node-Panel zu öffnen.
- Suche nach „handelsregister.ai“ und wähle den Node mit dem Verifiziert-Abzeichen.
- Klicke auf „Install“.
- Lege ein Credential „Handelsregister.ai API“ an und trag deinen API-Schlüssel ein. Alternativ geht ein Bearer-Token.
In einer selbst betriebenen Instanz installierst du den Node auch unter Settings › Community Nodes mit dem Paketnamen @handelsregister/n8n-nodes-handelsregister-ai.
Operationen
Der Node bietet die Endpunkte der API als Operationen. Die Credits sind dieselben wie in der API.
| Operation | Was sie tut | Credits |
|---|---|---|
| Fetch Organization | Firmenprofil mit wählbaren Features, AI-Mode und Echtzeit. | 5 + Features |
| Search Organizations | Firmen nach Namen und Filtern suchen. „Return All“ blättert alle Seiten durch, „Maximum Results“ begrenzt die Menge. | 1 pro Seite |
| Fetch Person | Personenprofil, ab Plus. | 15 |
| Fetch Document | Ein Dokument aus dem Register. Die Datei liegt danach in der Binär-Eigenschaft „data“. | 15 |
| List Signals | Signals nach Themen, Firmen und Zeitraum, Seite für Seite. | 20 pro Seite |
| Get Signal | Ein einzelnes Signal. | 20 |
| Get Signal Catalog | Die Themen der Signals. | kostenlos |
Lesende Anfragen wiederholt der Node bei Netzwerkfehlern, 408, 429 und Serverfehlern bis zu dreimal. Mit „Continue On Fail“ läuft der Workflow weiter, und das Ergebnis enthält Status, Fehlercode und meta.
Beispiel-Workflow
Dieser Workflow baut eine Liste aller aktiven GmbHs in einem Postleitzahlgebiet, jeweils mit ihrer Geschäftsführung.
- Starte mit einem Trigger, etwa „Manual Trigger“ zum Ausprobieren oder „Schedule Trigger“ für einen festen Takt.
- Füge den Node handelsregister.ai mit der Operation „Search Organizations“ hinzu. Setz in den Filtern die Postleitzahl, die Rechtsform GmbH und den Status aktiv.
- Stell „Output“ auf ein Item pro Firma. Schalte „Return All“ ein und begrenze die Menge mit „Maximum Results“. So weißt du vorab, wie viele Firmenprofile folgen.
- Füge einen zweiten Node handelsregister.ai mit „Fetch Organization“ hinzu. Trag in
qden Ausdruck{{ $json.entity_id }}ein und wähle das Feature Related Persons, die Geschäftsführung. - Schreib das Ergebnis in dein Ziel, etwa eine Tabelle oder dein CRM.