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> — 職種エリアの識別子（例：10000）
• --occupation-group <id> — 職種グループの識別子（例：10060）
• --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-area や --occupation-group を渡す前に、ESCO の職種識別子を 調べるために使用します。

タイプアヘッド候補

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

デンマーク語の職種名のオートコンプリート文字列を返します。search クエリを組み立てる前に、 有効なデンマーク語の職種名を探索するのに便利です。

---

効果的な使い方

まず職種を調べます。 search を実行する前に、occupations または suggestions を使って 適切なデンマーク語の用語や ESCO 識別子を見つけます：

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"

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

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

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

ページネーション：--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 はデンマーク語の職種名に合わせて調整されています。英語の用語では結果が空になることがあります。