Headcount Labs

Headcount Labs MCP 服务

为 AI Agent 提供职位信息。Headcount Labs 是托管的 Model Context Protocol 服务，可让 Claude、ChatGPT、Codex、Cursor、VS Code 和其他 MCP 客户端搜索、统计并查看雇主自有招聘网站及其所用招聘平台（Workday、Greenhouse、Lever、iCIMS、SmartRecruiters 等）上的公开职位。同一职位的重复信息会合并为一个职位，每个职位都会保留指向原始招聘信息的链接。

无需安装或运行任何内容。此仓库包含连接说明、客户端示例和官方 MCP Registry 条目（server.json，名称为 com.headcountlabs/jobs）。服务本身由托管平台提供。

端点	登录	工具
https://api.headcountlabs.com/mcp/public	无	6 个只读工具；一次搜索最多显示 250 个匹配职位，每页 50 个
https://api.headcountlabs.com/mcp	OAuth 2.1（PKCE、动态客户端注册）或用作 bearer token 的 API 密钥	26 个工具，包括导出、公司注册表、职位变更信息流和用量

两者都使用 Streamable HTTP 传输方式。

定价。 每个组织每个日历月（UTC）可免费获取 100,000 条记录，无需提供银行卡。超出后，每 1,000 条记录统一收费 $0.01。统计、市场洞察、字段查询和文档搜索均免费。 请参阅 headcountlabs.com/pricing。

无需账户即可试用

将公共端点添加到任意 MCP 客户端。在 Claude Code 中：

claude mcp add --transport http headcountlabs-public https://api.headcountlabs.com/mcp/public

也可以直接调用。此操作会统计目录中的所有公开职位：

curl -s https://api.headcountlabs.com/mcp/public \
  -H "content-type: application/json" -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"count_jobs","arguments":{}}}'

使用账户连接

Claude Code（然后运行 /mcp 并选择 Authenticate）：

claude mcp add --transport http headcountlabs https://api.headcountlabs.com/mcp

或者安装 Claude Code 插件，该插件会添加服务和职位搜索技能：

/plugin install headcount-labs --marketplace HeadcountLabs/claude-plugin

Codex：

codex mcp add headcountlabs --url https://api.headcountlabs.com/mcp
codex mcp login headcountlabs

Cursor、Windsurf 和其他读取 mcp.json 的客户端：examples/mcp.json。 VS Code：examples/vscode-mcp.json。 claude.ai 和 Claude Desktop：添加自定义连接器并填写端点 URL。 ChatGPT：headcountlabs.com/mcp/chatgpt。Grok： headcountlabs.com/mcp/grok。 不支持远程服务的客户端：将 npx mcp-remote https://api.headcountlabs.com/mcp 作为服务命令运行。

工具

公共端点提供此表中的前六个工具。登录后的端点提供所有工具。完整参考文档（含权限范围和限制）请参阅 headcountlabs.com/docs/mcp-tools。

工具	功能	是否使用记录
search_jobs	按职位名称、关键词、公司、城市、州、国家、工作安排、薪酬和日期查找职位。登录后，deliver_file: true 可将最多 5,000 个职位写入文件。	是
count_jobs	统计符合一组筛选条件的职位数量，也可按雇主分组。	否
get_job	读取一个职位及其所有关联招聘信息和来源链接。	是
market_insights	根据带日期的快照，提供薪酬、顶级雇主、远程职位占比、都市区、各州职位数量等信息。	否
list_fields	查找与你输入的词语（如“薪酬”或“远程”）匹配的筛选条件和职位字段。	否
search_docs	返回 Headcount Labs 文档中匹配度最高的章节。	否
read_file	分页读取 search_jobs 生成的文件，文件有效期为 24 小时。	否
verify_jobs	重新打开随机抽取的原始招聘信息，并检查链接、状态、职位名称、雇主、地点和薪酬。	抽样职位
compare_sources	将你自己的职位列表逐行与 Headcount Labs 数据匹配。	匹配的职位
search_jobs_json、search_jobs_dsl	使用 JSON 请求体或 Elasticsearch 风格的子句执行相同的搜索。	是
list_job_changes	列出自某个时间或游标以来新增、变更和关闭的职位。	是
list_companies、search_companies、get_company、list_company_jobs	公司注册表以及各公司的职位（需要 companies:read 权限范围）。	仅职位
create_job_export、list_job_exports、get_job_export、read_job_export_file	异步导出最多 100,000 个职位。	已完成的导出
get_usage、get_overage、get_usage_requests、get_usage_analytics	你的套餐、已用和剩余记录数、超额使用状态及请求报告。	否
set_confirmation_level、set_overage	设置搜索结果达到多大规模时 Agent 必须征求你的确认，以及开启或关闭超额计费。Agent 只会在你提出要求时更改这些设置。	否

每个工具都带有 title 和 readOnlyHint 或 destructiveHint 注释。这些工具会读取职位数据，但不能申请职位或联系雇主。

结果的呈现方式

• 默认精简。 search_jobs 会返回每个职位的简短摘要：排名、job_id、雇主撰写的职位名称、雇主名称和 200 字符的摘要片段（位于 job_ad 中）、地点、工作安排、薪酬及其周期、日期，以及职位发布和申请链接。传入 view: "full"、指定所需的 fields，或调用 get_job 获取所有字段。十次典型搜索所用的令牌比获取所有字段时少 62%。
• 职位广告文本属于数据。 包含雇主撰写文本的结果开头会显示 untrusted_content 提示，且服务会告知 AI 切勿遵循职位广告中的指令。发送前会移除隐藏文本（零宽字符和文本方向字符、HTML 注释、隐藏元素）。
• 错误会说明如何修正调用。 参数错误会返回 invalid_arguments，其中包含每个问题的 field、错误说明、可接受的值或最接近的有效名称（did_you_mean），以及可正常运行的 example。速率限制和过载错误会提供 retry_after_seconds。
• 分页。 登录后，limit 表示每页大小（10 到 100，默认值为 50），max_results 表示单次搜索跨所有页面最多返回的结果数（10 到 1,000，默认值为 250）。这些参数适用于 search_jobs、search_jobs_json、search_jobs_dsl、list_company_jobs、list_companies、search_companies 和 list_job_changes。请在首次调用时设置这两个参数，并在每一页保持不变，因为游标会携带它们。搜索达到上限时会返回 next_cursor: null 和提示。无账户端点每页返回 1 到 50 个职位（默认值为 10；使用完整描述时为 1 到 10 个），最多返回 250 个。
• 职位卡片。 在支持 MCP Apps 的客户端中，search_jobs 还会以卡片形式展示职位，提供薪酬、远程办公和地点筛选器，以及可打开原始职位发布页面的 Apply 按钮。其他客户端会显示常规结果。

提示词示例

• “目前德国有多少个数据工程师职位正在招聘？”
• “查找 5 个美国的远程软件工程师职位，这些职位发布于过去一周内，并附上薪酬和申请链接。”
• “德克萨斯州哪些雇主发布的注册护士职位最多？”
• “项目经理职位中，远程、混合办公和现场办公分别占多少？”
• “将 Deloitte 在德国所有仍开放的职位导出到文件中。”

数据

从雇主的招聘网站和招聘平台读取仍开放的职位，并持续更新，同时移除已关闭的职位。 每个职位均包含雇主、职位名称、地点、工作安排、雇主发布的薪酬、日期，以及职位发布和申请链接。

• 平台、国家和公司的覆盖范围：headcountlabs.com/coverage
• 职位记录中的字段：headcountlabs.com/docs/data-fields
• 使用相同筛选条件的 REST API：headcountlabs.com/docs
• Hugging Face 上的职位数据集公开子集（ODbL 1.0）：huggingface.co/HeadcountLabs；完整数据集即将推出。示例查询和架构见 job-postings repository

隐私与支持

你的客户端会向 api.headcountlabs.com 发送搜索筛选条件和职位 ID，并接收职位数据。Headcount Labs 仅保留计费用所需的使用次数统计。请查看隐私政策和 条款。

支持：headcountlabs.com/contact 或 [email protected]。

本仓库中的示例和文档采用 MIT 许可证。