# Firmenbuchat

> CLI für den Zugriff auf das österreichische Firmenbuch (HVD WebServices).

- Skill: `kbarbel640-del/firmenbuchat` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/firmenbuchat`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/firmenbuchat/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/firmenbuchat

---


# firmenbuchat

Setup (API-Key)
- `firmenbuchat config set-key`
- `export FIRMENBUCH_API_KEY="dein-key"`
- `.env`: `cp .env.example .env` und dann `firmenbuchat --env-file /pfad/zu/.env <command>`

Hilfe (alle Commands)
- `firmenbuchat help`

Common Commands
- Version: `firmenbuchat version`
- Info: `firmenbuchat info`
- Konfig anzeigen: `firmenbuchat config show`
- Konfig löschen: `firmenbuchat config delete --force`

Firmenbuchauszug
- `firmenbuchat auszug <FNR> [--stichtag YYYY-MM-DD] [--umfang "Kurzinformation"|"aktueller Auszug"|"historischer Auszug"]`

Firmensuche
- `firmenbuchat suche firma <SUCHBEGRIFF> [--bereich 1-6] [--exakt] [--gericht 007] [--rechtsform GES]`

Urkundensuche
- `firmenbuchat suche urkunde <FNR> [--output table|json|raw] [--limit 50] [--offset 0]`

Urkunden
- Info: `firmenbuchat urkunde info <URKUNDEN_KEY>`
- Download: `firmenbuchat urkunde download <URKUNDEN_KEY> [--output PATH]`

Veränderungen
- Firmen: `firmenbuchat veraenderungen firmen [--von YYYY-MM-DD] [--bis YYYY-MM-DD] [--gericht 007] [--rechtsform GES]`
- Urkunden: `firmenbuchat veraenderungen urkunden [--von YYYY-MM-DD] [--bis YYYY-MM-DD]`

Diagnose
- `firmenbuchat doctor [--env-file PATH]`

Globale Optionen
- `-o, --output`: `table` (default), `json`, `raw`
- `-k, --api-key`: API-Key direkt übergeben
- `-e, --env-file`: Pfad zu `.env` Datei
- `--limit`: Anzahl Ergebnisse (Tabellen)
- `--offset`: Start-Offset

Notes
- `veraenderungen urkunden` kann bei großen Zeiträumen 5xx liefern; kleinere Zeitfenster nutzen.
- Downloads brauchen einen `URKUNDEN_KEY` aus `suche urkunde`.