← Back to Skills Marketplace
1785
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install firmenbuchat
Description
CLI für den Zugriff auf das österreichische Firmenbuch (HVD WebServices).
README (SKILL.md)
firmenbuchat
Setup (API-Key)
firmenbuchat config set-keyexport FIRMENBUCH_API_KEY="dein-key".env:cp .env.example .envund dannfirmenbuchat --env-file /pfad/zu/.env \x3Ccommand>
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 \x3CFNR> [--stichtag YYYY-MM-DD] [--umfang "Kurzinformation"|"aktueller Auszug"|"historischer Auszug"]
Firmensuche
firmenbuchat suche firma \x3CSUCHBEGRIFF> [--bereich 1-6] [--exakt] [--gericht 007] [--rechtsform GES]
Urkundensuche
firmenbuchat suche urkunde \x3CFNR> [--output table|json|raw] [--limit 50] [--offset 0]
Urkunden
- Info:
firmenbuchat urkunde info \x3CURKUNDEN_KEY> - Download:
firmenbuchat urkunde download \x3CURKUNDEN_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.envDatei--limit: Anzahl Ergebnisse (Tabellen)--offset: Start-Offset
Notes
veraenderungen urkundenkann bei großen Zeiträumen 5xx liefern; kleinere Zeitfenster nutzen.- Downloads brauchen einen
URKUNDEN_KEYaussuche urkunde.
Usage Guidance
This skill appears to be a thin wrapper around the firmenbuchat CLI and looks generally coherent, but check these before installing: 1) The SKILL.md requires an API key (FIRMENBUCH_API_KEY) and .env usage even though the metadata lists no required env vars — verify how and where the key is stored (firmenbuchat config set-key), and whether it is saved in plaintext. 2) Inspect the brew formula in pasogott/tap and the GitHub repo (https://github.com/pasogott/firmenbuch-aip) before running 'uv add' or adding the tap to ensure there is no unexpected behavior. 3) When using a .env file or export, protect the file (restrict permissions) since it will contain a sensitive API key. If you need higher assurance, ask the publisher to declare required env vars in metadata and provide the brew formula and repository commit hash that will be installed.
Capability Analysis
Type: OpenClaw Skill
Name: firmenbuchat
Version: 0.2.3
The skill bundle is benign. It provides a CLI wrapper for the Austrian company register (Firmenbuch) API. The `skill.md` file details standard installation methods (Homebrew, uv from GitHub) and usage instructions for the `firmenbuchat` CLI tool. All commands and configurations, including API key handling, are directly related to the stated purpose of interacting with the Firmenbuch service. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent beyond the intended execution of the described commands.
Capability Assessment
Purpose & Capability
Name/description match the requested binary (firmenbuchat) and the documented commands in SKILL.md. Requiring the firmenbuchat binary (and providing a brew formula) is coherent for a CLI wrapper. However, the SKILL.md expects an API key (FIRMENBUCH_API_KEY) and shows .env handling even though the registry metadata lists no required environment variables; that mismatch should be clarified.
Instruction Scope
SKILL.md instructions stay focused on running the firmenbuchat CLI and setting an API key via config or env files. It does not instruct reading unrelated system paths or sending data to unexpected endpoints. The noteworthy item is that the instructions assume the agent (or user) will create/set an API key and may read a .env file — these environment interactions are within the skill's domain but are not reflected in the declared requirements.
Install Mechanism
Install spec includes a brew formula from a pasogott tap (pasogott/tap/firmenbuchat) which is standard for distributing a CLI, and an alternative 'uv add git+https://github.com/pasogott/firmenbuch-aip.git'. The brew tap is a third-party tap (not an official core formula) and the uv/git install will clone/execute code from the listed GitHub repo — both are traceable but worth inspecting before use.
Credentials
SKILL.md documents using an API key (FIRMENBUCH_API_KEY), passing -k/--api-key, and reading a .env file, yet the registry metadata lists no required env vars or primary credential. Asking for or reading an API key is reasonable for this purpose, but the metadata omission is a mismatch and the skill will require sensitive input (the API key) at runtime — users should confirm where the key is stored (local config, .env) and the storage/access protections.
Persistence & Privilege
The skill does not request always:true and does not declare persistent system-wide changes. Normal autonomous invocation is allowed (disable-model-invocation is false), which is standard. There is a mention of 'firmenbuchat config set-key' which likely stores the API key locally; users should verify where that is stored and file permissions but this behavior is within the skill's expected scope.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install firmenbuchat - After installation, invoke the skill by name or use
/firmenbuchat - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.3
firmenbuchat 0.2.3 Changelog
- Added detailed usage instructions and examples for setup, key configuration, and core commands.
- Expanded documentation on company search, document search and download, and change queries.
- Listed available installation methods (brew, uv) with guidance.
- Included troubleshooting notes and global CLI options for improved usability.
- Documented common issues and tips for large data requests and document downloads.
Metadata
Frequently Asked Questions
What is firmenbuchat?
CLI für den Zugriff auf das österreichische Firmenbuch (HVD WebServices). It is an AI Agent Skill for Claude Code / OpenClaw, with 1785 downloads so far.
How do I install firmenbuchat?
Run "/install firmenbuchat" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is firmenbuchat free?
Yes, firmenbuchat is completely free (open-source). You can download, install and use it at no cost.
Which platforms does firmenbuchat support?
firmenbuchat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created firmenbuchat?
It is built and maintained by pasogott (@pasogott); the current version is v0.2.3.
More Skills