jobnet-search

Jobnet-Search スキル

Jobnet.dk の公開 API から、デンマークの求人情報をリアルタイムで取得します。認証は不要です。 Jobnet は STAR（Styrelsen for Arbejdsmarked og Rekruttering）が運営する、デンマーク政府の公式求人ポータルです。公共部門の職種に加え、多くの民間企業の求人も掲載されています。常時およそ 21,000 件以上の有効な求人があります。

このスキルを使う場面

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

• キーワード、職種名、雇用主でデンマークの求人を検索する
• 地域、勤務時間（フルタイム／パートタイム）、雇用期間（常勤／臨時）で求人を絞り込む
• 指定した郵便番号から、指定範囲内の求人を探す
• 説明、連絡先、応募 URL を含む、特定の求人広告の詳細を取得する
• より正確に求人を絞り込むため、職種の種類と ESCO カテゴリを確認する
• デンマーク語の職種名やキーワードのオートコンプリート候補を確認する
• 公共部門、医療、IT、教育など、デンマークのあらゆる業界の求人を探す

コマンド

求人広告を検索する

bun run .agents/skills/jobnet-search/cli/src/cli.ts search [flags]

主なフラグ：

• --search-string <text> — キーワード検索。例：sygeplejerske、ingeniør、pædagog
• --region <region> — HovedstadenOgBornholm、Midtjylland、Syddanmark、OevrigeSjaelland、Nordjylland
• --postal-code <code> — 範囲検索に使う郵便番号。例：2100
• --radius <km> — 郵便番号からの半径（km、既定値：50）
• --work-hours <type> — FullTime または PartTime
• --duration <type> — Permanent または Temporary
• --job-type <type> — Ordinaert、Efterloenner、Foertidspension
• --occupation-area <id> — 職種分野 ID。例：10000
• --occupation-group <id> — 職種グループ ID。例：10060
• --occupation <uuid> — ESCO の職種を 1 つ指定します。occupations が出力する conceptUriDa、または末尾の UUID を指定してください
• --order <type> — PublicationDate（既定値）、BestMatch、ApplicationDate
• --page / --per-page / --limit
• --format json|table|plain

求人広告の詳細を取得する

bun run .agents/skills/jobnet-search/cli/src/cli.ts detail <jobAdId> [--format json|plain]

jobAdId は、search の結果に含まれる UUID です（jobAdId フィールド。すべての検索 CLI で共通するポータル契約上の名称である id としても出力されます）。求人の完全な説明、連絡先、応募締切、雇用主の詳細、応募先の直接 URL を取得します。

職種の種類を検索する

bun run .agents/skills/jobnet-search/cli/src/cli.ts occupations --search-string <text> [--per-page <n>]

search の --occupation に渡す前に、ESCO の職種 ID を確認するために使います。数値の --occupation-area／--occupation-group コードは別の分類体系です。職種 UUID をこれらに渡しても、求人は一致しません。

入力補完候補

bun run .agents/skills/jobnet-search/cli/src/cli.ts suggestions --query <text> [--limit <n>]

デンマーク語の職種名のオートコンプリート文字列を返します。search クエリを作成する前に、有効なデンマーク語の職種名を確認するのに便利です。

---

効果的な使い方

まず職種を確認します。 search を実行する前に、occupations または suggestions を使って適切なデンマーク語の用語や ESCO ID を確認します。

bun run .agents/skills/jobnet-search/cli/src/cli.ts suggestions --query "syge"
bun run .agents/skills/jobnet-search/cli/src/cli.ts occupations --search-string "sygeplejerske"
bun run .agents/skills/jobnet-search/cli/src/cli.ts search --occupation http://data.star.dk/esco/occupation/56f5d45c-ce48-43ac-9720-34831a1c8302

基本的なワークフロー：search → detail。

1. search を使って、一致する求人の一覧と jobAdId を取得します。
2. detail <jobAdId> を呼び出して、求人の完全な説明、連絡先、応募先の直接リンクを取得します。

比較には --format table、データ処理には --format json、単一レコードの詳細表示には --format plain を使います（求人本文の HTML が除去されます）。

ページネーション：--per-page はサーバー側でページごとに返す結果数を指定します。--limit は CLI の出力数に上限を設定します。大きな検索結果を順に取得するには、--page と --per-page を使います。

地理検索モード：

• 広い地域で絞り込むには --region を使います（例：Midtjylland 全域）
• 特定の場所の近くの求人を探すには、--postal-code と --radius を使います
• 同じクエリで --region と --postal-code を組み合わせないでください

検索目的に合わせて並び順を選びます：

• PublicationDate — 新しい求人を先に表示します（既定値。「新着情報」の確認に適しています）
• BestMatch — 関連度順に表示します（--search-string を指定した場合に最適です）
• ApplicationDate — 締切が早い求人を先に表示します（急ぎの応募に適しています）

---

使用例

コペンハーゲン地域の求人

bun run .agents/skills/jobnet-search/cli/src/cli.ts search \
  --region HovedstadenOgBornholm \
  --per-page 10 \
  --format table

全国の看護師求人

bun run .agents/skills/jobnet-search/cli/src/cli.ts search \
  --search-string "sygeplejerske" \
  --work-hours FullTime \
  --duration Permanent \
  --order BestMatch \
  --per-page 10 \
  --format table

オーフスから30km以内のIT求人

bun run .agents/skills/jobnet-search/cli/src/cli.ts search \
  --search-string "udvikler" \
  --postal-code 8000 \
  --radius 30 \
  --work-hours FullTime \
  --format table

求人情報の詳細

bun run .agents/skills/jobnet-search/cli/src/cli.ts detail 9ef43bce-d82b-4ea1-a098-7ff6520f99be --format plain

応募締め切り順の求人（締め切りが近いものから）

bun run .agents/skills/jobnet-search/cli/src/cli.ts search \
  --search-string "pædagog" \
  --region OevrigeSjaelland \
  --order ApplicationDate \
  --per-page 10

職種の用語を探す

bun run .agents/skills/jobnet-search/cli/src/cli.ts suggestions --query "ingeniør" --limit 5
bun run .agents/skills/jobnet-search/cli/src/cli.ts occupations --search-string "lærer" --per-page 5

---

出力形式

形式	最適な用途
json	デフォルト — プログラムでの利用、データ処理、コマンド間での ID の受け渡し
table	人がすばやく読み取れる概要や比較
plain	単一レコードの詳細表示（detail）。求人内容から HTML を除去します

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

---

注意事項

• すべてのデータは公開されている jobnet.dk/bff REST API から取得しており、認証情報は不要です。
• API では x-csrf: 1 ヘッダーが必要です。CLI が自動的に追加します。
• ページ番号は1から始まります（--page 1 が最初のページです）。
• search の結果には HTML の求人内容は含まれません。取得するには detail を使用してください。
• detail --format plain は、読みやすいテキスト出力にするため HTML タグを除去します。
• jobnet.dk の求人詳細ページ：https://jobnet.dk/find-job/{jobAdId}（外部求人以外。外部求人では雇用主の jobAdUrl を使用します）。
• suggestions はデンマーク語の職種名に合わせて調整されています。英語の用語では結果が空になる場合があります。