Firmendaten in n8n

Die Firmenakte-API ist eine gewöhnliche HTTP-Schnittstelle. In n8n braucht es deshalb keinen eigenen Firmenakte-Node: der eingebaute HTTP-Request-Node holt die Daten, und jeder weitere Node in n8n kann sie weiterverarbeiten – in eine Tabelle schreiben, in ein CRM eintragen oder als Nachricht verschicken.

Voraussetzungen

• Ein Firmenakte-Konto mit einem API-Key. Den Key legen Sie selbst im Dashboard unter firmenakte.at/app/api an; der Free-Plan reicht zum Ausprobieren.
• Eine n8n-Instanz, selbst gehostet oder bei n8n Cloud.

Schritt 1: Den API-Key als Credential hinterlegen

Legen Sie in n8n unter Credentials ein neues Credential vom Typ Header Auth an:

• Name: x-api-key
• Value: Ihr API-Key So liegt der Key einmal in n8n und steht nicht im Klartext in einem Node.

Schritt 2: Einen HTTP-Request-Node anlegen

Fügen Sie einen HTTP Request-Node ein und stellen Sie ihn so ein:

• Method: GET
• URL: https://api.firmenakte.at/api/v1/businesses
• Authentication: Generic Credential Type → Header Auth → das Credential aus Schritt 1
• Send Query Parameters: an, zum Beispiel
• • city = Wien
  • legalFormCode = GES
  • active = true
  • pageSize = 50 Ein Klick auf Execute step liefert die Antwort als JSON. Die Treffer liegen im Feld data, dazu kommen pageNumber, pageSize, totalRecords und totalPages. Jeder Treffer trägt unter anderem fnr, name, legalForm.text, isActive, addresses und registeredSince. Für ein einzelnes Unternehmen lautet die URL https://api.firmenakte.at/api/v1/businesses/{fnr}, etwa …/businesses/34853f. Die Antwort enthält das vollständige Profil: Adressen, Funktionen, Gewerbeberechtigungen, Edikte, Dokumente und die Kennzahlen der Jahresabschlüsse. Welche Filter und Endpoints es gibt, steht in der API-Dokumentation.

Schritt 3: Die Treffer aufteilen

Die Liste kommt als ein einziges Item mit dem Array data an. Ein Split Out-Node mit dem Feld data macht daraus ein Item pro Unternehmen. Danach lässt sich jedes Feld in den folgenden Nodes direkt per Drag-and-drop oder als Ausdruck wie {{ $json.name }} verwenden.

Schritt 4: Die Daten dorthin bringen, wo sie gebraucht werden

Ab hier ist es ein normaler n8n-Workflow. Beispiele:

• Google Sheets → Append Row: eine Zeile je Unternehmen, Spalten aus fnr, name, legalForm.text, addresses[0].city.
• HubSpot, Pipedrive, Airtable, Notion: Datensatz anlegen oder aktualisieren, die Firmenbuchnummer als eindeutigen Schlüssel verwenden.
• Slack, E-Mail, Teams: Nachricht mit den Treffern verschicken.

Änderungen laufend abfragen

Wer einen Bestand beobachten will, lässt den Workflow regelmäßig laufen:

1. Schedule Trigger – zum Beispiel stündlich.
2. HTTP Request auf https://api.firmenakte.at/api/v1/globalchanges/aggregated mit dem Query-Parameter sinceId = die höchste id, die beim letzten Lauf verarbeitet wurde. Die Antwort bündelt businessChanges, documentChanges, ediktChanges und globalChanges in einer Antwort, bis zu 2.000 Einträge je Typ. Mit dem Parameter fnr lässt sich der Feed auf ein einzelnes Unternehmen einschränken.
3. Die höchste id für den nächsten Lauf merken – etwa in einer Zelle eines Google Sheets, in einer n8n Data Table oder in den Workflow Static Data eines Code-Nodes. Ein Request je Intervall genügt damit für eine Überwachung über den gesamten Bestand. sinceId ist exklusiv: Sie übergeben die letzte verarbeitete id und erhalten nur, was danach kam.

Kontingent

Jeder Request zählt auf das monatliche Requestkontingent des Plans. Der Stand ist im Dashboard unter firmenakte.at/app/api sichtbar. Mit pageSize bis 100 und dem aggregierten Änderungsfeed kommt ein Monitoring mit wenigen Requests am Tag aus.

KI-Agenten in n8n

Wer in n8n einen KI-Agenten baut, kann statt einzelner HTTP-Requests den MCP-Server der Firmenakte anbinden: der MCP Client-Node mit der URL https://mcp.firmenakte.at/mcp, Anmeldung mit dem Firmenakte-Konto. Der Agent erhält damit jeden Endpoint der API als Werkzeug. Wie das eingerichtet wird, beschreibt der Leitfaden zum Claude-Konnektor und die Seite firmenakte.at/entwickler/mcp.