Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/hh-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@theyahia/hh-mcp

用于 hh.ru API 的 MCP 服务器 —— 覆盖俄罗斯和独联体国家求职市场。19 个工具，涵盖职位、简历、雇主、薪资统计、字典、自动补全和令牌诊断。

默认情况下，响应以紧凑的、适合 LLM 阅读的摘要形式返回 —— 向任何搜索/详情工具传入 raw: true 即可获取完整的 hh.ru JSON。

npm CI License: MIT

属于 @theYahia 的 Russian API MCP 系列的一部分。

两种模式

模式

可用功能

需要令牌？

无令牌

职位搜索、按 ID 获取职位、相似职位、雇主、薪资统计、地区、职业角色、行业、地铁、字典、自动补全、令牌检查

否

有令牌

以上全部 + 简历搜索、按 ID 获取简历

是（HH_ACCESS_TOKEN）

在 dev.hh.ru/admin 获取令牌。注意：简历搜索额外需要雇主账户并开通付费简历数据库订阅 —— 求职者/匿名令牌会收到 403 错误。使用 validate_token 检查你的令牌可以做什么。

Related MCP server: laddro-career-mcp

安装

Claude Desktop

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "optional-oauth-token"
      }
    }
  }
}

Claude Code

claude mcp add hh -- npx -y @theyahia/hh-mcp
# With token:
claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp

VS Code / Cursor

{
  "servers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"]
    }
  }
}

Windsurf

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"]
    }
  }
}

HTTP 模式（Streamable HTTP）

npx @theyahia/hh-mcp --http
# or
HTTP_PORT=8080 npx @theyahia/hh-mcp --http

端点：http://localhost:3000/mcp（POST）· 健康检查：http://localhost:3000/health（GET）

HTTP 模式是无状态的，默认绑定到 127.0.0.1，并启用了 DNS 重绑定保护。要对外暴露，请设置 HOST=0.0.0.0，将你的主机/来源添加到 HH_ALLOWED_HOSTS / HH_ALLOWED_ORIGINS，并将其置于你自己的认证之后。

环境变量

变量

必需

描述

HH_ACCESS_TOKEN

否

OAuth 2.0 Bearer 令牌。简历端点需要（雇主 + 付费简历数据库）。

HH_USER_AGENT

否

自定义 HH-User-Agent（hh.ru 要求提供）。建议格式 your-app/1.0 (you@example.com)。

HTTP_PORT / PORT

否

HTTP 模式端口（默认：3000）。

HOST

否

HTTP 模式下绑定的接口（默认：127.0.0.1）。

HH_ALLOWED_HOSTS

否

HTTP 模式的 Host 允许列表，逗号分隔（默认：回环地址）。

HH_ALLOWED_ORIGINS

否

HTTP 模式的 Origin 允许列表，逗号分隔。

参见 .env.example。

工具（19 个）

每个搜索/详情工具都接受 raw: true，以返回完整的 hh.ru JSON 而不是紧凑摘要。

职位

工具

描述

令牌？

search_vacancies

按关键词、地区、职业角色、行业、地铁、雇主、薪资、经验、工作形式/雇佣形式、日期范围（period 或 date_from/date_to）、标签、搜索字段进行搜索，支持排序和分页

否

get_vacancy

完整职位详情：描述、要求、关键技能、联系方式

否

get_similar_vacancies

查找与给定职位相似的职位

否

简历（雇主令牌 + 付费简历数据库）

工具

描述

令牌？

search_resumes

按关键词、地区、角色、薪资、经验搜索候选人简历

是

get_resume

完整简历：工作经历、教育背景、技能、联系方式

是

雇主

工具

描述

令牌？

search_employers

按名称和地区搜索公司

否

get_employer

雇主档案：描述、行业、网站、职位数量

否

get_employer_vacancies

列出特定雇主的在招职位

否

字典与自动补全

工具

描述

令牌？

get_areas

地区和城市树（id — name）

否

get_areas_subtree

某个地区 ID 下的地区/城市 —— 比完整树更轻量

否

get_professional_roles

带 ID 的职业角色树

否

get_industries

带 ID 的公司行业树

否

get_metro

某城市的地铁站/线路及 ID

否

get_dictionaries

所有参考数据：货币、雇佣类型、工作制、经验、标签

否

suggest_positions

职位名称自动补全

否

suggest_companies

公司名称自动补全

否

suggest_areas

地区/城市名称自动补全

否

薪资与账户

工具

描述

令牌？

get_salary_statistics

某地区某角色的估算薪资分布（中位数、P25/P75、最低/最高），根据已发布职位的薪资计算。样本有偏差，并非官方市场数据。

否

validate_token

检查 HH_ACCESS_TOKEN 是否有效（通过 /me）并报告账户角色

否

速率限制

内置速率限制器遵守 hh.ru API 每秒 5 次请求的限制。遇到 429 和 5xx 错误时自动重试，采用指数退避（最多 3 次尝试）。注意：限制器是进程全局的，因此在共享 HTTP 模式下，所有客户端共享同一个 5 次/秒的预算。

演示提示词

Find remote Python developer jobs in Moscow paying over 300,000 RUB
Show me all open vacancies at Yandex and give me salary statistics for their top roles
Compare Senior Backend salaries in Moscow vs Saint Petersburg, and suggest similar vacancies to the best-paying one

开发

git clone https://github.com/theYahia/hh-mcp.git
cd hh-mcp
npm install
npm run build
npm test

API 参考

许可证

MIT

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • HeadHunter MCP Server

    gmen1057
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search job vacancies, manage resumes, and apply to jobs on HeadHunter (hh.ru), Russia's largest job search platform. Includes OAuth 2.0 integration for secure job applications and an automated vacancy hunter agent with intelligent matching.
    27
    MIT

  • HuntFlow MCP Server

    theYahia
    A
    license
    B
    quality
    C
    maintenance
    Integrates with HuntFlow ATS to manage vacancies, candidates, resumes, and recruitment stages via 7 tools and 2 skill prompts.
    7
    50
    1
    MIT

  • HeadHunter API MCP Server

    sargonpiraev
    A
    license
    Not graded
    quality
    F
    maintenance
    Enables AI assistants to access and manage HeadHunter job platform data, including vacancies, resumes, negotiations, and employer settings via 167+ tools.
    85
    5
    MIT

View all related MCP servers

Related MCP Connectors

  • YouTube Transcript & Search MCP Server

    YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.

  • Human Pages

    Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.

  • Sugra API

    Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/hh-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server