hiringindex-mcp

hiringindex-mcp

基于实时职位信息的 MCP 服务。搜索职位、汇总细分市场，并查看每个职位信息已开放多久。

零依赖，Node ≥ 18，stdio 传输。

安装

npx -y hiringindex-mcp

先获取一个密钥——免费。 BASIC 计划每月 $0，可查询 200 条职位信息和 5 项洞察：在 https://rapidapi.com/starnikovoleg/api/hiringindex/pricing 订阅，并将密钥填入下方的 HIRINGINDEX_API_KEY。

Claude Desktop / Claude Code：

{
  "mcpServers": {
    "hiringindex": {
      "command": "npx",
      "args": ["-y", "hiringindex-mcp"],
      "env": { "HIRINGINDEX_API_KEY": "your-key" }
    }
  }
}

工具

工具	可回答的问题
search_jobs	“帮我找找阿姆斯特丹薪资超过 80k 的 Python 数据岗位。”
job_market_insights	“柏林的数据工程师薪资是多少？哪些公司在招聘？”
posting_age_report	“这些职位信息是新发布的吗？还是已经开放几个月了？”
get_job	“给我这个 ID 对应的完整职位信息。”

posting_age_report 会报告职位信息的开放时长中位数、本周发布的占比，以及开放超过 60 天仍未关闭的占比——这是最常被引用的信号，表明该岗位可能并未在积极招聘。它只报告数据，不会假装知道雇主的意图。

与现有工具的定位。 有一款免费工具 whenthisjobwasposted.com，可以一次查询 一个 URL 对应职位信息的真实发布时间，也有自己的 MCP 服务。如果这正是你需要的，就用它——完全免费。本工具回答的是另一个问题：整个细分市场的职位信息开放时长 分布，并针对同一群体同时计算薪酬和需求情况。一个用于查询单条信息，另一个用于汇总分析。

四个工具使用相同的筛选条件格式，因此定义一次细分市场后，即可进行搜索、汇总和开放时长分析，无需重写查询。

筛选条件

以下是实时索引可以应用的筛选条件（已于 2026-09-07 对照市场平台上的列表核实，board_handle 于 2026-09-08 添加）。其他内容均不是筛选条件，且工具架构采用封闭定义，因此模型无法自行编造筛选条件。

字段	含义	备注
titles	匹配的职位名称	索引会拒绝长度少于 3 个字符的词条
keywords	职位信息任何位置（标题或描述）提及的词语	匹配任意关键词；自 2026-09-08 起生效——此前仅匹配标题
city	雇主所用的城市名称	"Berlin"、"New York"、"Bengaluru"
country	ISO 3166-1 alpha-2 代码或英文名称	"US"、"Germany"；名称会在本地映射为代码
work_arrangement	Remote / In Person	上游没有将混合办公作为单独的筛选条件
company	按名称指定一家雇主
board_handle	按 handle 指定一个 ATS 招聘板	从职位信息的 handle 字段中获取："EndeavorITSolution"、"walmart:wd504:WalmartExternal"
salary_min / salary_max	公布的薪资范围	仅匹配公开薪资的职位信息
posted_within_days	过去 N 天内发布
page / limit	分页，limit 最大为 100	仅适用于 search_jobs

此处未提供但索引支持的筛选条件：seniority 和 employment_type。它们的值是供应商提供的原始字符串（"Mid-Senior Level"、"FullTime"），模型可能会猜错拼写，导致结果集为空；不过汇总数据仍会按雇主所用的原始值报告这两项。上游完全不提供的筛选条件：地区或州、行业。

配置

变量	默认值	含义
HIRINGINDEX_API_KEY	—	必填；也接受 RAPIDAPI_KEY。免费 BASIC 计划：https://rapidapi.com/starnikovoleg/api/hiringindex/pricing
HIRINGINDEX_HOST	hiringindex.p.rapidapi.com	市场平台主机
HIRINGINDEX_API_BASE	—	设置此项可直接调用我们的后端，而不经过市场平台
HIRINGINDEX_TIMEOUT_MS	30000	请求超时时间

设置 HIRINGINDEX_API_BASE 后，认证方式会从 x-rapidapi-key 切换为 x-api-key，并完全跳过市场平台。

握手为何在本地进行

这些工具会直接调用 REST 端点，而不是代理远程 /mcp。 市场会按照声明的路径对每个请求计费，包括 initialize 和 tools/list。通过此软件包调用时，握手不会离开本机，只有实际查询才会产生费用。

输出

默认输出 Markdown——重复字段会渲染为表格，与带标签的列表相比可节省 token， 同时也便于人类阅读。对任何工具传入 format: "json"，即可获取原始响应。

开发

npm test          # 16 protocol checks, no key needed
HIRINGINDEX_API_KEY=... npm test   # 17 — adds live calls through the marketplace

测试会像真实客户端一样驱动服务：向 stdin 写入 JSON-RPC， 并从 stdout 读取。

发布前

1. 使用真实密钥进行冒烟测试：已于 2026-09-07 通过市场完成，17/17 （搜索、洞察、年龄报告、单条招聘信息）。每次发布前都要重新运行。
2. 执行 git init，并在 package.json 中添加 repository。
3. 市场主机已确定（hiringindex.p.rapidapi.com，自 2026-09-07 起公开上架），因此 config.js 中的默认值无需进行重大版本升级。
4. 提交至官方 MCP 注册表（无需把关人），然后提交至 Docker MCP Registry 和 Cline 市场。

关于注册表上架信息的说明

在官方注册表中，115 个与求职相关的服务里，描述是浏览者唯一会阅读的内容，而会被安装的服务通常定位明确： 面向一个国家、一个行业或一个职业类别。“AI 求职”与其他十几个服务毫无区别。要突出数字、数据来源和 工具列表，以及其他服务都未涉及的年龄角度。