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 字段，也会作为 id 输出，这是每个搜索 CLI 共享的 portal-contract 名称）。返回完整的职位 描述、联系人、申请截止日期、雇主详情和直接申请 URL。

搜索职业类型

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

使用此命令在将 ESCO 职业标识符传给 search 的 --occupation-area 或 --occupation-group 之前发现它们。

输入联想建议

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 进行数据处理， 使用 --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

Aarhus 附近 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 针对丹麦语职位名称进行了优化——英文词语可能不会返回任何结果。