Quellenkontor HR-Daten

Quellenkontor

API、SDK、CLI、MCP を通じてドイツの公的な HR 数値を提供します。すべての数値に出典、法的根拠、有効期間が付いています。

最低賃金、社会保険料算定基準、保険料率、現物給付評価額、州ごとの祝日、解雇予告期間など、さらに 17 種類のデータセットを提供します。基準日を指定して問い合わせると、その日に適用される数値と、連邦官報または連邦公報の出典箇所を取得できます。

ウェブサイト · ドキュメント · 無料のキー · ガイド · 英語

---

なぜ提供しているのか

ドイツの人事・給与計算ソフトは、どれも同じ数値を管理しています。1 月 1 日や 7 月 1 日、そして政令が公布されるたびに更新が必要です。多くの場合、担当者、表計算シート、カレンダーの予定に依存しています。数値の入力が遅れたり間違ったりすると、給与計算に誤りが生じても、すぐには気付かないことがあります。

Quellenkontor がこうした管理を代行します。各数値は公的な情報源から取得して確認し、有効期間とともに保存します。将来の数値は、公布されてから登録します。省庁の草案段階では登録しません。具体的な手順については、確認プロセスをご覧ください。

回答の例

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15"

{
  "datensatz": "mindestlohn",
  "datum": "2027-01-15",
  "mindestlohn_brutto_stunde": 14.6,
  "minijob_grenze_monat": 633,
  "gueltig_ab": "2027-01-01",
  "gueltig_bis": null,
  "rechtsgrundlage": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), Stufe 2",
  "quelle": {
    "titel": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268)",
    "url": "https://www.recht.bund.de/bgbl/1/2025/268/VO.html"
  },
  "vorheriger_wert": {
    "gueltig_ab": "2026-01-01",
    "mindestlohn_brutto_stunde": 13.9,
    "minijob_grenze_monat": 603
  }
}

この問い合わせにはキーが不要です。最低賃金、祝日、算定基準額は、1 日 50 回まで利用できるサンドボックスで回答されます。ここでは回答を省略していますが、完全版には注記、ライセンス、すぐに使える引用文も含まれています。

対象ユーザー

開発しているもの	Quellenkontor が代行すること
給与計算ソフト	算定基準額、保険料率、現物給付評価額、移行領域の数値を、過去の日付も含め、任意の基準日について提供します。詳細
HR ソフトウェア	州ごとの祝日、労働日、解雇予告期間、休暇取得権、母性保護に関する計算ツールを提供します。詳細
HR チャットボットと AI エージェント	エージェントが記憶に頼って数値を答えるのではなく、照会できる MCP サーバーを提供します。詳細
給与計算と Employer of Record	多数の行政機関のウェブサイトを追いかける代わりに、ドイツの給与計算値を一元的に提供します。詳細

ガイド

よくある作業について、コピーして使えるコード付きの簡単な手順を紹介します。

• 最低賃金とミニジョブの上限額を常に最新に保つ
• 給与計算の年次更新に備える
• 州ごとの祝日と労働日
• 解雇予告期間を正しく計算する
• MCP を使って AI エージェントで HR の数値を取得する

背景情報を含むその他のユースケースについては、quellenkontor.dev/anwendungsfaelleをご覧ください。

データセット

分野	データセット
給与	最低賃金とミニジョブの上限額、最低職業訓練報酬、介護分野の最低賃金
社会保険	算定基準額、保険料率、移行領域（ミディジョブ）、ミニジョブの負担金、芸術家社会保険料、均等化負担金
税金	現物給付評価額、非課税額、国内出張費、SFN 割増手当、社用車、所得税の基準額
労働法と期限	解雇予告期間、休暇取得権、母性保護、休憩規則、通常定年年齢、差押禁止限度額
カレンダー	州ごとの祝日、労働日

各データセットのパラメーターとフィールドは、リファレンスをご覧ください。データセットの一覧は、https://api.quellenkontor.dev/v1/datensaetzeから JSON 形式で取得できます。

はじめに

このリポジトリには公式クライアントが含まれています。必須の依存関係はなく（非同期 Python クライアントのみ httpx が必要です。pip install "quellenkontor[async]"）、同じ API を利用します。

パッケージ	インストール	ドキュメント
JavaScript/TypeScript SDK	npm install @quellenkontor/sdk	JavaScript SDK
Python SDK	pip install quellenkontor	Python SDK
CLI	npm install -g @quellenkontor/cli	コマンドライン
MCP サーバー	https://mcp.quellenkontor.dev/v1（ガイドで設定）	MCP

import { Quellenkontor } from "@quellenkontor/sdk";

const qk = new Quellenkontor(process.env.QK_KEY);

const frist = await qk.hr.kuendigungsfrist({ eintritt: "2017-03-01", zugang: "2026-11-10" });
console.log(frist.ende); // "2027-02-28"

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])

ml = qk.hr.mindestlohn(datum="2027-01-15")
print(ml["mindestlohn_brutto_stunde"])  # 14.6

npx @quellenkontor/cli feiertage --jahr 2027 --land HE --format csv > feiertage.csv

月間 500 回のクエリが可能な無料キーは、quellenkontor.dev/anmelden から入手できます。パスワードもクレジットカードも不要です。最初のクエリまでの手順はクイックスタートをご覧ください。

お問い合わせ

バグの報告やご要望は、Issue または [email protected] までお寄せください。

このリポジトリのクライアントは MIT ライセンスで提供されています。データは API が提供し、その利用条件は利用規約に記載されています。

---

English

API、SDK、CLI、MCP を通じて利用できる、ドイツの公式人事関連参照データです。すべての値に公式の出典、法的根拠、適用日が付いています。

最低賃金、社会保険の上限額と料率、現物給付、州ごとの祝日、解雇予告期間、さらに 17 種類のデータセットを収録しています。基準日を指定してクエリを実行すると、その日に適用される値を、連邦官報または連邦公報の出典情報とあわせて取得できます。フィールド名とパラメーター名は API と同様、ドイツ語です。

• ドキュメント：quellenkontor.dev/en/docs
• 無料キー（月間 500 リクエスト）：quellenkontor.dev/en/sign-in
• パッケージ：npm install @quellenkontor/sdk、pip install quellenkontor、npm install -g @quellenkontor/cli