Unified Jobs MCP Server

统一职位 MCP 服务

一个零依赖的 Model Context Protocol 服务，为 AI Agent 提供单一来源职位工具无法做到的功能：跨来源去重的职位信息流。它会查询申请人跟踪系统、LinkedIn 公开访客搜索，以及 Hacker News 的 “Who is hiring?” 主题帖，然后将在多个来源看到的同一职位合并为一条规范记录——其中包含 sources[] 数组，以及最丰富的薪资信息、最长的描述和最早的发布日期。Agent 获得的是一份整洁的列表，而不是三份彼此重叠的列表和一个需要自行解决的去重问题。

• 无需 API 密钥、账户或登录。 所有数据都来自无需密钥的公开端点。
• 零依赖。 通过标准输入/输出手写符合规范的 JSON-RPC 2.0——无需 SDK，也不会在 Agent 的信任边界内引入传递依赖包树。通过 npx 即可即时安装并启动。
• 仅包含公开职位信息。 不含会员数据，除公开职位字段外不含个人身份信息（PII）。

安装

Claude Desktop（claude_desktop_config.json）/ Cursor / Cline / Continue：

{
  "mcpServers": {
    "unified-jobs": {
      "command": "npx",
      "args": ["-y", "github:rezearcher/unified-jobs-mcp"]
    }
  }
}

或者直接运行：

npx -y github:rezearcher/unified-jobs-mcp

工具

search_unified_jobs

跨来源职位信息流。一次调用即可拉取一家或多家公司的 ATS 职位板（companies[]）、搜索 LinkedIn（keywords + location），和/或查询当前的 HN 主题帖，并获取一份去重后的列表。多个来源上的同一职位会合并为一条记录：

{
  "title": "Backend Software Engineer - Infrastructure",
  "company": "Palantir",
  "location": "United States",
  "salary": "$135,000 - $200,000 / yr",
  "posted_at": "2026-10-14T00:00:00.000Z",
  "sources": [
    { "source_platform": "lever",    "url": "https://jobs.lever.co/palantir/..." },
    { "source_platform": "linkedin", "url": "https://www.linkedin.com/jobs/view/..." }
  ],
  "primary_url": "https://jobs.lever.co/palantir/...",
  "merged": true
}

每组结果都会报告去重统计信息：raw_source_hits、canonical_jobs、cross_source_merges、collapsed、per_source_hits。

字段	说明
companies	ATS 公司：简写别名（"stripe"）、域名（"stripe.com"）或 "platform:token"（"lever:palantir"、"workday:tenant.wd5:Site"）。对于简写别名/域名，会自动检测 ATS 和 token。
keywords、location	LinkedIn 搜索（keywords 也会筛选 HN）。
sources	["ats","linkedin","hn"] 的子集。默认：全部三项。
maxPerSource	合并前每个来源的行数上限（默认 25，最大 200）。
maxResults	合并后规范记录的数量上限（可选）。
remoteOnly、dedupe、includeDescription	布尔值；dedupe 默认启用。

search_hn_hiring

仅查询 Hacker News 当前月份的 “Ask HN: Who is hiring?” 主题帖，并将其规范化为相同的架构。每月主题帖 ID 会自动发现（每月 1 日轮换），并将每条自由文本帖子的标题解析为结构化字段。可选的 query / remoteOnly 筛选条件。

list_sources

列出来源类别、ATS 公司的指定方式，以及跨来源去重的具体行为。 不会发起网络调用。

来源

类别	覆盖范围	无需密钥
ats	Greenhouse、Lever、Ashby、SmartRecruiters、Workday、Recruitee、Workable	✅
linkedin	公开访客职位搜索（关键词 + 地点）	✅（云 IP 上会触发速率限制 → 降级为开放模式）
hn	当前月份的 “Who is hiring?” 主题帖	✅

每个来源都经过封装，因此即使单个来源发生故障（例如 LinkedIn 的访客端点对云 IP 进行速率限制），也不会导致整个调用失败——你仍会获得成功返回的来源数据。托管的计量版还提供 Indeed 和轮换住宅代理，以支持大量请求。

去重工作原理

• 规范键： company | title | city，会去掉法律实体后缀，但保留资历和职位限定词——因此 Backend - Infrastructure 和 Backend - Defense 会保持为不同职位。
• 合并： 标量字段按来源优先级顺序取第一个非空值；薪资信息整体取自信息最丰富的单个来源（保证内部一致）；posted_at 取最早日期；描述取最长版本；sources[] 汇总所有来源。
• 开放模式降级： 无法推导出键的职位行会作为独立记录输出，并标记为 merged: false——绝不会被悄然丢弃。

维护

GitHub Actions 烟雾测试工作流会在每次推送时以及每天运行真实的 MCP 客户端握手和实时跨源拉取。ATS 和 HN 系列作为门槛；LinkedIn 仅供参考（云 IP 速率限制）。 上游格式发生实质性变化时，往返测试会失败，并自动创建跟踪问题——确保信息流持续正常运行，而不是任其腐坏。

许可证

MIT © Grey Ridge Signals Group LLC