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.

Diese Seite ist bewusst dünn: das eine Muster, die drei Kernflüsse, ein Wegweiser. Tieferes steht in den Fokus-Guides und in der aus dem Code generierten Referenz.

Das eine 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), Query-Parameter daneben (&fn=…).

Drei Kernflüsse

①Firmen & Personen finden

curl "https://skale.dev/firmenindex/api?e=search%2Frich&query=brantner"
curl "https://skale.dev/firmenindex/api?e=search%2Feu&query=friseur&ort=Neusiedl%20am%20See"

Query-Sprache, Wildcards, Umlaut-Faltung, Branche/Ort-Chips, Personensuche: agents-suche.html — Suche-Guide →

②Firmenprofil ziehen (alles Aufbereitete)

curl "https://skale.dev/firmenindex/api?e=lookup%2Fmerged&fn=475207i"
curl "https://skale.dev/firmenindex/firma/brantner-oesterreich-gmbh-475207i.md"   # token-arm als Markdown

Ein Call → Stammdaten, Personen/Organe, Gesellschafter, Beteiligungen, letzte Vollzüge, Publikationen. Die .md-Fassung jeder Firma ist fürs Lesen optimiert (weniger Tokens, kein HTML-Parsing); ihre „Weiteres“-Sektion trägt die firma-spezifischen Calls gleich mit.

③Dokumente & Bilanzdaten (öffentliche Plattformen)

curl "https://skale.dev/firmenindex/api?e=hvd%2Fsuche-urkunde&fnr=475207i"   # Liste: key · Art · Datum · PDF/XML
curl "https://skale.dev/firmenindex/api?e=hvd%2Furkunde-get&key=<KEY>"       # rohes PDF — oder Bilanz-XML
curl "https://skale.dev/firmenindex/api?e=bilanz&fn=475207i"                 # Bilanz-Zahlen fertig ausgezählt
curl "https://skale.dev/firmenindex/api?e=auszug%2F475207i&fmt=md"           # Firmenbuchauszug (fmt=pdf|md)

XML-Semantik (FinanzOnline-Strukturdaten vs. eingebettete base64-PDFs), Stichtags-Auszug, Höflichkeit bei MB-großen Urkunden: agents-dokumente.html — Dokumente-Guide →

Abdeckung — Soll/Ist je Bestand

Live aus api?e=status (Feld abdeckung). Soll-Lücken sind ehrlich offen, nie geraten.

Bestand	Ist	Soll	Quelle/Hinweis
lädt…

Weiter aufbereitet — je eine Zeile

GISA-Gewerbe je Firma: gisa/{fn} · Lizenz-Detail: gisa/detail/{gisazahl}
Insolvenzen/Edikte: insolvenz/{fn}
Vollzugs-Historie (Zeitreise): hvd/historie?fnr=…&von=…&bis=… · letzte Vollzüge stecken in lookup/merged
Konzern-/Eigentümer-Graph (GLEIF): gleif/{fn}
Verflechtungs-Netzwerk (2 Ebenen, DB-first): firmen/{fn}/netzwerk?max_items=12 → {gesellschafter, beteiligungen} mit fn/person/role/since/status je Knoten; Firmen-Kanten nur mit resolve exact, Personen ohne FN (person: true) nie verlinkt; n_weitere_* zählt hinter dem maxItems-Aufklapper; anteil ist ehrlich null (keine Quelle führt strukturierte Anteile) · nutzt die Baum-Sektion auf jeder Detailseite
Zeitmaschine (punkt-in-zeit): firmen/{fn}/zustand?stichtag=YYYY-MM-DD → Name + Organbesetzung an JEDEM Tag per Vollhistorie-replay aus dem Cache (kein Live-Call) · Eigentümer als seit-befund (since ≤ stichtag, Austritte in Kanten nicht erfasst) · historie_quelle: historie_cache-replay | nicht_berechnet (dann pointer auf hvd/historie?at=) · Stichtag vor Gründung → existiert: false
UBO-Kontrolle: firmen/{fn}/kontrolle?max_tiefe=6 → Aufwärts-Pfade „wer kontrolliert diese firma?“ je Kante mit quelle/since-beleg · ende: person | firma_ohne_fn | zyklus | tiefe_erreicht | keine_kante_erfasst ehrlich je blatt · anteil bleibt null (keine Stimmrechts-Aggregation, Prio-1d/2b) · DB-only
Öffentliche Vergaben (TED): firmen/{fn}/vergaben → EU-Vergabenotices, bei denen diese Firma als Gewinner steht (notice, lot, ort, datum) · fn nur aus belegtem winner-identifier (oft die FN selbst) — nie aus Namen geraten · DB-first aus ted_awards (write-through-backfill)
ÖNACE: Firmen je Branche oenace/companies?code=5621 (edv-Code, ohne Punkte) · Baum oenace/tree
Personen: person/search?q=… · Werdegang person/karriere?q=…&fn=…
Standorte: standorte?fn=… · UID-Check (VIES): uid-check?uid=…
Quellen-Status: status

Exakte Parameter immer aus der Referenz, nie von Hand kopiert: api?e=openapi.json (OpenAPI 3, aus dem laufenden Code generiert — kann nicht veralten) · api-docs.html (gerendert).

Die Seite bedienen — URLs

URL	Ziel
`./?q=<query>`	Suche ausführen (Ergebnisseite)
`./?fn=<FN>`	Firmen-Detail (z. B. `./?fn=475207i`) — je Firma als `.md`: `firma/<slug>-<fn>.md`
`./?gz=<GISAZAHL>`	Gewerbe-Detail

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.
Diese drei Seiten (Hub + 2 Guides) sind reines HTML — ohne JS lesbar; nur die Abdeckungstabelle hier lädt live nach.

Quellen & Lizenz

evi.gv.at + HVD Firmenbuch (Republik Österreich / BMJ, CC BY 4.0), GISA, WKO, ÖNACE (Statistik Austria). Details und Aktualität: Info & Datenquellen.

Firmenindex AT