Command-line tool and TypeScript library

`jobsuche`

Search Germany’s federal job database from your terminal. jobsuche is a small command-line tool over the Bundesagentur für Arbeit Jobsuche API (rest.arbeitsagentur.de/jobboerse/jobsuche-service): find job listings by keyword, location, radius or employer, and fetch the full record for any posting — as clean JSON you can pipe straight into jq.

Version 0.0.6 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the jobsuche command:

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

Access

Needs the free, publicly documented API key: pass --api-key or set JOBSUCHE_API_KEY. No key is bundled; the README explains where to get it.

Quick start

jobsuche search --was Informatiker --wo Berlin --size 10

Commands

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 job listings
details

Full job details by reference number (refnr) or encoded code

All commands, arguments and options →

Claude Code skills

The jobsuche plugin teaches Claude to use jobsuche. Install it from the maschinenlesbar.org marketplace:

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

/jobsuche:jobsuche-employer-watch
/jobsuche:jobsuche-job-hunt
/jobsuche:jobsuche-market-scan

Skill descriptions and requirements →

TypeScript library

@maschinenlesbar.org/jobsuche-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.

API reference → Library usage and architecture →

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.