Command-line tool and TypeScript library
ausbildungssuche
Search Germany’s federal apprenticeship and vocational-training catalogue from your terminal. ausbildungssuche is a small command-line tool over the Bundesagentur für Arbeit Ausbildungssuche API: find training offers by keyword, location, profession or region, and fetch the full record for any offer — as clean JSON you can pipe straight into jq.
Install
Needs Node.js 20 or newer. Installs the ausbildungssuche command:
npm i -g @maschinenlesbar.org/ausbildungssuche-cliAccess
Needs the free, publicly documented API key: pass --api-key or set AUSBILDUNGSSUCHE_API_KEY. No key is bundled; the README explains where to get it.
Quick start
eval "$(ausbildungssuche obtain-key --export)"
ausbildungssuche search --orte "Köln_6.957_50.938" --uk 25 --size 10Commands
-
obtain-keyObtain 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.
-
searchSearch apprenticeship/training offers
-
detailsFull details for one apprenticeship offer by id
Claude Code skills
The ausbildungssuche plugin teaches Claude to use ausbildungssuche. Install it from the maschinenlesbar.org marketplace:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install ausbildungssuche@maschinenlesbar/ausbildungssuche:ausbildung-finder/ausbildungssuche:ausbildung-market-scan/ausbildungssuche:ausbildung-offer-brief
What the skills answer, with real examples → Skill descriptions and requirements →
TypeScript library
@maschinenlesbar.org/ausbildungssuche-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.
The tool, not the data
The data comes from the provider behind the API, under its own terms — see DATA_LICENSE.md. The code is dual-licensed AGPL-3.0-or-later or commercial — see LICENSING.md.