Firmenindex Österreich — für Agenten

Durchsuchbarer Index österreichischer Firmen: 300k+ Firmenbuch-Einträge (evi.gv.at + HVD) plus nicht-eingetragene Gewerbe (GISA/WKO), ÖNACE-klassifiziert. Alles auf dieser Seite ist maschinenlesbar — kein Login, keine Cookies, kein Browser nötig.

Daten per API — ein Muster

curl "https://skale.dev/firmenindex/api?e=<ENDPOINT>&<PARAMS>"

e = URL-encodeter Endpoint-Pfad (search/rich → search%2Frich); Pfad-Parameter kommen direkt in e (auszug%2F475207i).

# Firma finden → Profil
curl "https://skale.dev/firmenindex/api?e=search%2Frich&query=brantner"
curl "https://skale.dev/firmenindex/api?e=lookup%2Fmerged&fn=475207i"

Die vollständige Referenz wird aus dem laufenden Code generiert und kann nicht veralten:

Maschinell: curl "https://skale.dev/firmenindex/api?e=openapi.json" (OpenAPI 3)
Gerendert: api-docs.html — 40 Endpoints: Suche, Profil, Auszug (PDF/MD), Historie, Gesellschafter/Beteiligungen, Eigentümer-Graph, Personen mit Identitäts-Gruppierung, GISA, ÖNACE, Insolvenzen, Registerticker.
Reine Markdown-Fassung je Firma (weniger Tokens als HTML, kein Parsing-Overhead):
https://skale.dev/firmenindex/firma/{slug}-{fn}.md — z. B. firma/brantner-oesterreich-gmbh-475207i.md. Jede HTML-Firmen-Seite trägt <link rel="alternate" type="text/markdown"> + HTTP-Link-Header darauf.

Die Seite bedienen — URLs & Query-Sprache

URL	Ziel
`./?q=<query>`	Suche ausführen (Ergebnisseite)
`./?fn=<FN>`	Firmen-Detail (z. B. `./?fn=475207i`)
`./?gz=<GISAZAHL>`	Gewerbe-Detail

Query	Bedeutung
`Brantner`	Firmenname (auch Teilwort)
`475207i`	FN → direkt zum Firmenbuch-Detail
`Patricia Neumann`	Person (GF, Vorstand, Prokurist, Gesellschafter)
`maier`	Teilwort-Suche (HVD-Wildcard)
`friseur` + Ort-Chip	Gewerbe im Bezirk — Ort-Chip via `#neu…` (nur Orte) oder Autocomplete

Schreibweisen sind egal: Könczöl ≈ Koenczoel, laß ≈ lass, ö↔oe, ß/ss/sz werden automatisch gefaltet.

Autocomplete für Chips: api?e=suggest&q=elek (Branchen) · api?e=suggest&q=%23neu (nur Orte/PLZ).

Höflichkeit & Fehler

Upstream-Rate-Limit ~30 req/min — gecachte Firmen (lookup/merged, Cache-first) belasten es nicht. Cache zuerst, höflich batchen.
Fehler sind JSON: {"detail":{"error":{type,message}}} mit passendem HTTP-Status.
Ausfälle sind ehrlich: fällt eine Live-Quelle aus, trägt der Payload "degradiert": true — es werden nie gefälschte Daten geliefert.

Progressive Affordances

Daten-Sektionen im Firmen-Detail tragen ihren exakten API-Call am Entstehungsort (aufklappbar „Für Agenten", z. B. der GLEIF-Konzerngraph).
Karten tragen data-lei/data-name/data-status/… — direktes DOM-Parsing ohne API-Call.

Quellen & Lizenz