entgeltatlas

Install

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

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

Access

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

Quick start

entgeltatlas codes                              # dimension code tables (offline, no key)
entgeltatlas entgelte 84304                     # salary stats for a KldB occupation
entgeltatlas entgelte 84304 -l 4 -r 1 -g 1      # Experte, Deutschland, all genders
entgeltatlas regionen                           # live region codes
entgeltatlas entgelte 84304 --compact | jq '.[0].entgelt'

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.

• entgelte

  Gross-salary statistics for a KldB-2010 occupation code

• regionen

  List region codes (the `r` dimension)

• geschlechter

  List gender codes (the `g` dimension)

• alter

  List age-band codes (the `a` dimension)

• branchen

  List branch/industry codes (the `b` dimension)

• codes

  Print the dimension code tables (l/r/g/a/b) — works offline, no API key

All commands, arguments and options →

Claude Code skills

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

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

• /entgeltatlas:entgelt-code-finder
• /entgeltatlas:entgelt-gap-analyzer
• /entgeltatlas:entgelt-lookup

Skill descriptions and requirements →

TypeScript library

@maschinenlesbar.org/entgeltatlas-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.