mcpField
J
jobdanmark-search

jobdanmark-search

github.com/madslorentzen生産性67.9k193 回インストール3 日前に更新
リポジトリ

jobdanmark-search について

jobdanmark-searchは、認証不要の公開APIを使ってデンマークのJobdanmark.dkを検索するコマンドラインスキルです。カテゴリ別の求人件数や、検索を絞り込む職種の補完・場所の候補も取得できます。

主な機能

  1. 01キーワード、場所、カテゴリ、雇用形態で検索
  2. 02求人のページ送りと詳細取得
  3. 03カテゴリと現在の求人件数を表示
  4. 04職種名とカテゴリのオートコンプリート
  5. 05市町村、郵便番号、地域の候補を提示

活用シーン

  1. 01コペンハーゲンのフルタイムIT職を探す
  2. 02オーフスの学生アルバイトを検索
  3. 03カテゴリ別の現在の求人件数を確認
  4. 04郵便番号で絞り込んで求人詳細を読む

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/madslorentzen/ai-job-search --skill jobdanmark-search

インストール後、Claude Code で/jobdanmark-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

cli/
package.json
README.md
tsconfig.json
cli/src/
cli.ts
helpers.ts
cli/src/commands/
autocomplete.ts
categories.ts
detail.ts
locations.ts
search.ts
cli/tests/
autocomplete-filtering.test.ts
cli-contract.test.ts
cli-flag-validation.test.ts
detail-backoff.test.ts
detail-jsonld.test.ts
detail-parsing.test.ts
detail-url-normalization.test.ts
helpers.ts
missing-option-values.test.ts
request-timeout.test.ts
retry-backoff.test.ts
search-normalization.test.ts
user-agent.test.ts

詳細

Jobdanmark 検索スキル

Jobdanmark.dk の公開 API から、デンマークの最新求人情報にアクセスできます。認証は不要です。 10 カテゴリ、デンマークのすべての自治体にまたがる約 15,000 件以上の有効な求人情報をカバーしています。

このスキルを使うタイミング

ユーザーが次のことを望む場合にこのスキルを呼び出します。

  • デンマークの求人情報を検索する(キーワード、場所、カテゴリ、雇用形態別)
  • 特定のデンマークの都市、自治体、郵便番号、地域で利用可能な求人を閲覧する
  • 雇用形態(フルタイム、パートタイム、学生アルバイト、見習いなど)で求人を絞り込む
  • 説明や締め切りを含む、特定の求人投稿の詳細全体を調べる
  • 現在の有効な求人件数とともにすべての求人カテゴリを一覧表示する
  • 検索語を求人タイトル ID またはカテゴリ ID に解決して、正確に絞り込む
  • 求人検索フィルター用の場所候補(自治体、郵便番号、地域)を見つける

コマンド

求人情報を検索する
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search [flags]

主なフラグ:

  • --text <keyword> — フリーテキスト検索。例: elektriker、sygeplejerske、softwareudvikler
  • --category <id> — カテゴリ ID(下記のカテゴリ表を参照)
  • --jobtitle-id <id> — autocomplete の結果から得られる求人タイトル ID
  • --municipality <name> — 例: Odense、København、Aarhus
  • --zip <code> — 郵便番号。例: 5000、8000、2100
  • --region <name> — 地域名。例: Midtjylland、Sjælland
  • --job-type <types> — カンマ区切り: fuldtid、deltid、fleksjob、elev、studiejob、praktik
  • --page <n> — ページ番号(1 ページ 30 件、サーバーで固定)
  • --limit <n> — CLI が返す合計結果数の上限
  • --format json|table|plain

1 ページあたりの件数は API により 30 件に固定されています。ページネーションには --page を使用してください。

求人の詳細全体
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts detail <slug> [--format json|plain]

slug は search の結果で slug として返される URL パスセグメントです(例: it-chef-soeges-til-rah)。 求人ページから完全な構造化求人データを返します。CLI は Schema.org JSON-LD が存在する場合はそちらを優先し、Jobdanmark が JSON-LD を省略している場合はレンダリングされた HTML の解析にフォールバックします。

有効な件数とともにカテゴリを一覧表示する
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts categories [--format json|table|plain]

現在の有効な求人件数とともに、10 個すべての求人カテゴリを返します。ユーザーに求人市場の概要を示すのに役立ちます。

求人タイトルとカテゴリをオートコンプリートする
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts autocomplete --query "<text>" [--limit <n>]

これを使用して、検索語を search 用の正確な求人タイトル ID(--jobtitle-id)またはカテゴリ ID(--category)に解決します。結果の value フィールドが search に渡す ID です。

場所を提案する
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts locations --query "<text>" [--limit <n>]

一致する自治体、郵便番号、地域を返します。結果の value を search の --municipality または --zip として使用してください。


カテゴリ

IDデンマーク語英語
227972Pædagogik, Uddannelse og ForskningEducation, Research
227973Håndværk, Industri, Transport og LandbrugCrafts, Industry, Transport, Agriculture
227974Salg, Kommunikation, Marketing, og DesignSales, Communication, Marketing, Design
227975Pleje, Social og SundhedCare, Social, Health
227976Hotel, Service, Restauration og SikkerhedHotel, Service, Restaurant, Security
227977Kontor, Finans og ØkonomiOffice, Finance, Economy
227978IT, Ingeniør og EnergiIT, Engineering, Energy
227979Ledelse, HR og projektstyringManagement, HR, Project Management
543415Kirke, Kultur og UnderholdningChurch, Culture, Entertainment
227980Øvrige jobOther jobs

効果的な使い方

まず場所を解決します。 search に渡す前に、locations を使って正しい自治体名または郵便番号を確認してください。

bun run .agents/skills/jobdanmark-search/cli/src/cli.ts locations --query "Aarhus" --format plain

精度を高めるために職種を解決します。 ユーザーが特定の職種を希望している場合は、autocomplete を使って正確な職種 ID を取得してください。

bun run .agents/skills/jobdanmark-search/cli/src/cli.ts autocomplete --query "sygeplejerske" --format plain

自然なワークフロー: search → detail。

  1. search を使って、一致する求人の一覧を slug とともに取得します。
  2. detail <slug> を呼び出して、説明、締切、組織の詳細を含む求人票の全文を取得します。

比較には --format table を、データ処理には --format json を、単一レコードの詳細表示には --format plain を使用してください。

ページネーション: API は 1 ページあたり 30 件を返します (サーバー側で強制)。結果を移動するには --page を使用します。ページサイズに関係なく CLI の出力を制限するには --limit を使用します。

フィルターを組み合わせると、正確な結果が得られます — たとえば --text + --job-type + --municipality はすべて 1 回の検索リクエストで一緒に機能します。


使用例

コペンハーゲンの IT 求人
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search \
  --category 227978 \
  --municipality "København" \
  --job-type fuldtid \
  --format table
デンマーク全国の看護求人
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search \
  --text "sygeplejerske" \
  --category 227975 \
  --format table
オーフスの学生求人
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search \
  --municipality "Aarhus" \
  --job-type studiejob \
  --format table
現在最も活発な求人カテゴリは?
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts categories --format table
特定の求人票の詳細
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts detail it-chef-soeges-til-rah --format plain
郵便番号 8000 の求人を探す
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search --zip 8000 --format table
どのような電気技師の求人が利用可能ですか?
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search \
  --text "elektriker" \
  --category 227973 \
  --job-type "fuldtid,deltid" \
  --format table
デンマーク全国の見習い職
bun run .agents/skills/jobdanmark-search/cli/src/cli.ts search \
  --job-type elev \
  --page 1 \
  --format table

出力形式

形式最適な用途
jsonデフォルト — プログラムでの利用、データ処理、コマンド間での ID の受け渡し
table人間がすばやく読める概要と比較
plain単一レコードの詳細表示 (detail)

すべてのエラーは { "error": "...", "code": "..." } として stderr に書き込まれ、プロセスはコード 1 で終了します。


注意事項

  • すべてのデータは公開されている Jobdanmark.dk API からのものです — 認証情報は不要です。
  • ページネーションは 1 始まりです (--page 1 が最初のページです)。1 ページあたり 30 件で、サーバー側で強制されます。
  • detail コマンドは HTML の求人ページを取得し、利用可能な場合は埋め込まれた JSON-LD を解析します。構造化データを省略しているページには、レンダリング済み HTML のフォールバックを使用します。別の JSON API は使用しません。
  • 検索結果の slug は、API の相対 url フィールド (/job/ の後のパス) から抽出されます。また、すべての検索 CLI が共有するポータル契約名である id としても出力されます。
  • 検索結果の applicationDeadline は null になる場合があります (締切が設定されていません)。
  • フィルターで使用する職種の値: fuldtid、deltid、fleksjob、elev、studiejob、praktik。

コメント