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=… |
Jede Schreibweise passt: 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 — 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 |
|---|---|
/suche?q=<query> | Suche ausführen (Ergebnisseite) |
/firma/<FN> | Firmen-Detail — je Firma als Markdown: firma/<slug>-<fn>.md |
Höflichkeit
Suchen treffen den Upstream (Rate-Limit ~30 req/min) — nicht in enger Schleife, Ergebnisse cachen. Detail-Lookups (lookup/merged) kommen cache-first.