Kommandozeilen-Tool und TypeScript-Bibliothek
jobsuche
Die bundesweite Stellendatenbank direkt im Terminal durchsuchen. jobsuche ist ein kleines Kommandozeilen-Tool für die Jobsuche-API der Bundesagentur für Arbeit (rest.arbeitsagentur.de/jobboerse/jobsuche-service): Stellenangebote nach Stichwort, Ort, Umkreis oder Arbeitgeber finden und den vollständigen Datensatz zu jedem Angebot abrufen – als sauberes JSON, das Sie direkt an jq weitergeben können.
Installation
Benötigt Node.js 20 oder neuer. Installiert den Befehl jobsuche:
npm i -g @maschinenlesbar.org/jobsuche-cliZugang
Benötigt den kostenlosen, öffentlich dokumentierten API-Schlüssel: per --api-key oder über JOBSUCHE_API_KEY. Es ist kein Schlüssel enthalten; woher Sie ihn bekommen, steht in der README.
Schnellstart
jobsuche search --was Informatiker --wo Berlin --size 10Befehle
Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.
-
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 job listings
-
detailsFull job details by reference number (refnr) or encoded code
Skills für Claude Code
Das Plugin jobsuche bringt Claude bei, jobsuche zu nutzen. Installation über den Marketplace von maschinenlesbar.org:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install jobsuche@maschinenlesbar/jobsuche:jobsuche-employer-watch/jobsuche:jobsuche-job-hunt/jobsuche:jobsuche-market-scan
TypeScript-Bibliothek
@maschinenlesbar.org/jobsuche-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.
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.