Suche-Guide

Ebene 2 — Details zum Fluss ① des Agenten-Hubs. Exakte Parameter immer aus api?e=openapi.json; alle Beispiele hier sind live geprüft.

Firmen & Personen: search/rich

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

query versteht mehrere Formen, branche/ort sind Facetten (die Chips der UI):

Query	Bedeutung
Brantner	Firmenname (auch Teilwort)
475207i	FN → direkt zum Firmenbuch-Detail (dann lookup/merged&fn=…)
Patricia Neumann	Person (GF, Vorstand, Prokurist, Gesellschafter)
*maier*	Teilwort-Suche (HVD-Wildcard)
friseur + Ort-Facette	Gewerbe im Bezirk — Facette via &ort=… bzw. Branche via &branche=…

Schreibweisen sind egal: Könczöl ≈ Koenczoel, laß ≈ lass, ö↔oe, ß/ss/sz werden automatisch gefaltet. Gut schreiben, nicht rätseln.

Facetten-Chips: Autocomplete via suggest

Die UI baut Branche/Ort-Chips über Autocomplete — Agenten nutzen denselben Call, um gültige Facetten-Werte zu ermitteln (nie raten):

curl "https://skale.dev/firmenindex/api?e=suggest&q=elek"    # Branchen → &branche=…
curl "https://skale.dev/firmenindex/api?e=suggest&q=%23neu"  # NUR Orte/PLZ → &ort=…

In der UI: # zeigt nur Orte, Komma trennt Facetten, ⌫ löscht den letzten Chip.

Ohne Firmenbuch-Eintrag: search/eu

Eintragen lassen vs. eingetragen: viele Gewerbe (GISA/WKO) stehen nicht im Firmenbuch. Diese „e.U.“-Lane hat einen eigenen Endpoint — gleiches Facetten-Muster:

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

Langsame Lane (Live-Poll): der Call antwortet sofort mit Teilergebnis und liefert weitere Treffer nach (Muster /search/eu-Poll) — erst nach Stabilisierung als vollständiges Ergebnis werten.

Personen: person/search & person/karriere

curl "https://skale.dev/firmenindex/api?e=person%2Fsearch&q=patricia%20neumann&limit=5"
curl "https://skale.dev/firmenindex/api?e=person%2Fkarriere&q=…&fn=475207i"

person/search gruppiert Namensvetterinnen zu Identitäten (Geburtsdatum = einziger Identitätsbeweis) — Rollen-Filter via &role=, Deckel via &limit=. person/karriere liefert den Werdegang einer Person, bezogen auf eine FN (include_historic für Vergangenes).

Browser-URLs (falls doch gerendert werden soll)

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

Höflichkeit

Suchen treffen den Upstream (Rate-Limit ~30 req/min) — nicht in enger Schleife, Ergebnisse cachen. Detail-Lookups (lookup/merged) kommen cache-first.