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> — 地区名称，例如 Midtjylland、Sjælland
• --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 用作 search 中的 --municipality 或 --zip。

---

类别

ID	丹麦语	英语
227972	Pædagogik, Uddannelse og Forskning	Education, Research
227973	Håndværk, Industri, Transport og Landbrug	Crafts, Industry, Transport, Agriculture
227974	Salg, Kommunikation, Marketing, og Design	Sales, Communication, Marketing, Design
227975	Pleje, Social og Sundhed	Care, Social, Health
227976	Hotel, Service, Restauration og Sikkerhed	Hotel, Service, Restaurant, Security
227977	Kontor, Finans og Økonomi	Office, Finance, Economy
227978	IT, Ingeniør og Energi	IT, Engineering, Energy
227979	Ledelse, HR og projektstyring	Management, HR, Project Management
543415	Kirke, Kultur og Underholdning	Church, Culture, Entertainment
227980	Øvrige job	Other jobs

---

如何高效使用

先解析地点。 使用 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。