Kommandozeilen-Tool und TypeScript-Bibliothek

`ausbildungssuche`

Den bundesweiten Katalog für Ausbildungs- und Berufsbildungsangebote direkt im Terminal durchsuchen. ausbildungssuche ist ein kleines Kommandozeilen-Tool für die Ausbildungssuche-API der Bundesagentur für Arbeit: Angebote nach Stichwort, Ort, Beruf oder Region finden und den vollständigen Datensatz zu jedem Angebot abrufen – als sauberes JSON, das Sie direkt an jq weitergeben können.

Version 0.0.6 npm GitHub API-Referenz

Installation

Benötigt Node.js 20 oder neuer. Installiert den Befehl ausbildungssuche:

npm i -g @maschinenlesbar.org/ausbildungssuche-cli

Zugang

Benötigt den kostenlosen, öffentlich dokumentierten API-Schlüssel: per --api-key oder über AUSBILDUNGSSUCHE_API_KEY. Es ist kein Schlüssel enthalten; woher Sie ihn bekommen, steht in der README.

Schnellstart

eval "$(ausbildungssuche obtain-key --export)"
ausbildungssuche search --orte "Köln_6.957_50.938" --uk 25 --size 10

Befehle

Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.

obtain-key

Obtain the public X-API-Key this API requires and print it. The key is published by the Bundesagentur für Arbeit and is not a secret; none is bundled with this package, so it is read from the source at run time.
search

Search apprenticeship/training offers
details

Full details for one apprenticeship offer by id

Alle Befehle, Argumente und Optionen →

Skills für Claude Code

Das Plugin ausbildungssuche bringt Claude bei, ausbildungssuche zu nutzen. Installation über den Marketplace von maschinenlesbar.org:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install ausbildungssuche@maschinenlesbar

/ausbildungssuche:ausbildung-finder
/ausbildungssuche:ausbildung-market-scan
/ausbildungssuche:ausbildung-offer-brief

Was die Skills beantworten, mit echten Beispielen → Beschreibungen und Voraussetzungen der Skills →

TypeScript-Bibliothek

@maschinenlesbar.org/ausbildungssuche-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.

API-Referenz → Nutzung als Bibliothek und Architektur →

Das Werkzeug, nicht die Daten

Die Daten stammen vom Anbieter hinter der API und unterliegen dessen Bedingungen – siehe DATA_LICENSE.md. Der Code steht unter AGPL-3.0-or-later oder einer kommerziellen Lizenz – siehe LICENSING.md.