jobdanmark-search

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> — 地区（locations 类别 region），例如 Sjælland、Østjylland、Fyn
• --administrative-region <name> — 五个行政区之一（locations 类别 administrativeRegion），例如 Region Midtjylland
• --job-type <types> — 逗号分隔：fuldtid、deltid、fleksjob、elev、studiejob、praktik
• --page <n> — 页码（每页 30 条，由服务端强制设定）
• --limit <n> — 限制 CLI 返回的结果总数
• --format json|table|plain

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）。 返回职位页面中的完整结构化数据。若存在 Schema.org JSON-LD，CLI 会优先使用；如果 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>]

使用此命令将搜索词解析为精确的职位名称 ID（--jobtitle-id）或类别 ID（--category），以供 search 使用。结果中的 value 字段就是要传给 search 的 ID。

建议地点

bun run .agents/skills/jobdanmark-search/cli/src/cli.ts locations --query "<text>" [--limit <n>]

返回匹配的市镇、邮政编码和地区。将项目的 value 传给其 category 对应的 search 标志：municipality → --municipality、zip → --zip、region → --region、administrativeRegion → --administrative-region。如果将值传给错误的标志，则不会匹配到任何职位。

---

类别

ID	丹麦语	英语
227972	Pædagogik, Uddannelse og Forskning	教育、研究
227973	Håndværk, Industri, Transport og Landbrug	手工艺、工业、运输、农业
227974	Salg, Kommunikation, Marketing, og Design	销售、传播、营销、设计
227975	Pleje, Social og Sundhed	护理、社会服务、健康
227976	Hotel, Service, Restauration og Sikkerhed	酒店、服务、餐饮、安全
227977	Kontor, Finans og Økonomi	办公、金融、经济
227978	IT, Ingeniør og Energi	IT、工程、能源
227979	Ledelse, HR og projektstyring	管理、人力资源、项目管理
543415	Kirke, Kultur og Underholdning	教会、文化、娱乐
227980	Øvrige job	其他职位

---

如何高效使用

先解析地点。 使用 locations 查找正确的市镇名称或邮编，然后再传给 search：

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 每页返回 30 条（由服务端强制）。使用 --page 浏览结果。使用 --limit 限制命令行输出，不受页面大小影响。

组合过滤条件以获得精确结果 — 例如 --text + --job-type + --municipality 可在一次搜索请求中同时生效。

---

使用示例

哥本哈根的 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 是第一页）。每页 30 条，由服务端强制。
• detail 命令会抓取 HTML 职位页面，并在可用时解析内嵌的 JSON-LD，对于省略结构化数据的页面则回退到渲染后的 HTML。它不使用单独的 JSON API。
• 搜索结果中的 slug 从 API 的相对 url 字段中提取（即 /job/ 之后的路径）；它也会作为 id 输出，这是所有搜索命令行共用的门户契约名称。
• 搜索结果中的 applicationDeadline 可以为 null（未设置截止日期）。
• 用于筛选的职位类型值：fuldtid、deltid、fleksjob、elev、studiejob、praktik。