firmenbuchat

Narzędzie CLI do wyszukiwania i pobierania danych z austriackiego Firmenbuch (rejestru handlowego). Wyszukuj firmy po nazwie, pobieraj aktualne i historyczne wyciągi rejestrowe, przeszukuj urkund oraz śledzić zmiany w rejestrze. Wymaga klucza API do HVD WebServices i obsługuje wiele formatów wyjścia: tabelę, JSON lub surowe dane.

1. Zainstaluj firmenbuchat za pomocą brew lub uv. Dla brew: uruchom brew install pasogott/tap/firmenbuchat. Dla uv: wykonaj uv add git+https://github.com/pasogott/firmenbuch-aip.git.

2. Skonfiguruj klucz API. Uruchom firmenbuchat config set-key i podaj swój klucz API do HVD WebServices. Alternatywnie ustaw zmienną środowiskową export FIRMENBUCH_API_KEY="twój-klucz" lub skopiuj plik .env.example na .env, wstaw klucz i uruchom komendy z flagą --env-file.

3. Wyszukaj firmę po nazwie za pomocą firmenbuchat suche firma "nazwa-firmy". Możesz zawęzić wyniki flagami --bereich (obszar sądu), --exakt (dokładne dopasowanie) lub --rechtsform (forma prawna).

4. Pobierz wyciąg rejestrowy firmy, znając jej numer FNR, komendą firmenbuchat auszug FNR. Możesz określić datę (--stichtag YYYY-MM-DD) i zakres danych (--umfang "Kurzinformation"|"aktueller Auszug"|"historischer Auszug").

5. Wyszukaj urkund (dokumenty) dla firmy komendą firmenbuchat suche urkunde FNR. Wyniki możesz formatować jako tabelę, JSON lub surowe dane flagą --output. Pobierz konkretny dokument komendą firmenbuchat urkunde download URKUNDEN_KEY.

6. Sprawdź zmiany w rejestrze za pomocą firmenbuchat veraenderungen firmen (dla firm) lub firmenbuchat veraenderungen urkunden (dla dokumentów), podając zakresy dat --von i --bis w formacie YYYY-MM-DD.