Hh Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.0更新于 Oct 28, 2026

MCP server for hh.ru jobs API — vacancy search, salary stats, employers, regions. Public endpoints,

已验证STDIO仅桌面网页搜索与抓取数据与分析商业与电商

概览

AI 生成的概览

面向 hh.ru 招聘 API 的 MCP 服务器，让助手搜索职位与简历、查询雇主、地区和薪资统计。

可以做什么
  • 按关键词、地区、职业角色、行业、地铁、薪资、经验和办公形式搜索职位，并获取职位详情或相似职位
  • 搜索求职者简历并读取完整简历信息（需雇主令牌及已付费的简历库）
  • 搜索雇主、查看雇主资料并列出其在招职位
  • 查询参考数据：地区树、职业角色、行业、地铁站、字典，以及职位、公司、地区的自动补全
  • 获取某地区某角色的估算薪资分布（中位数、P25/P75、最小/最大值），并校验访问令牌
适用场景
适合让助手直接回答俄罗斯及独联体地区的招聘市场问题，例如查找带薪资与经验要求的匹配职位、比较不同城市或角色的薪酬、调研雇主，而不是只返回搜索结果链接。
运行要求
通过 npx 作为 Node.js 包在本地运行，也可选用仅监听本机的 HTTP 模式。职位、雇主和参考数据查询无需令牌；简历搜索需要 HH_ACCESS_TOKEN 中的 OAuth 令牌，且须为雇主账号并已付费订阅简历库。建议设置 HH_USER_AGENT，因为 hh.ru 有此要求。
安装前请注意
HH_ACCESS_TOKEN 是凭据；简历接口会返回候选人个人信息和联系方式，需谨慎处理结果。简历访问在 hh.ru 侧需要付费订阅。薪资统计基于已发布职位的估算，样本有偏差，并非官方市场数据。若将 HTTP 模式开放到本机之外，需自行添加身份验证并配置允许的 host 与 origin。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hh Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP-сервер для hh.ru API — 19 инструментов для ИИ-агента: вакансии, резюме, зарплаты

Если вы искали, как подключить hh.ru к Claude или другому ИИ-агенту, — этот сервер даёт агенту поиск по вакансиям и резюме, карточки работодателей, статистику зарплат и справочники hh.ru по России и СНГ. Спрашиваете «найди Python-вакансии в Москве от 250 000 ₽ на удалёнке» — агент возвращает готовый список с зарплатами и опытом, а не ссылку на выдачу. Поиск вакансий работает без токена; токен нужен только для базы резюме.

[npm] [CI] [License: MIT]

[Демонстрация: вопрос «найди Python-вакансии в Москве от 250 000 ₽ на удалёнке» — агент вызывает search_vacancies и отвечает списком вакансий]

По умолчанию ответы приходят компактными сводками, удобными для LLM — передайте raw: true любому инструменту поиска или карточки, чтобы получить полный JSON hh.ru.

Часть серии WWmcp от @theYahia.

Два режима

РежимЧто доступноНужен токен?
Без токенаПоиск вакансий, вакансия по ID, похожие вакансии, работодатели, статистика зарплат, регионы, роли, отрасли, метро, справочники, подсказки, проверка токенанет
С токеномВсё перечисленное + поиск резюме, резюме по IDда (HH_ACCESS_TOKEN)

Токен выдаётся на dev.hh.ru/admin. Важно: поиск резюме дополнительно требует аккаунт работодателя с оплаченной подпиской на базу резюме — токены соискателя и анонимные получают 403. Проверить возможности своего токена можно инструментом validate_token.

Установка

Claude Desktop

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

Claude Code

bash
claude mcp add hh -- npx -y @theyahia/hh-mcp# С токеном:claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp

VS Code / Cursor

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

Windsurf

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

Режим HTTP (Streamable HTTP)

bash
npx @theyahia/hh-mcp --http# илиHTTP_PORT=8080 npx @theyahia/hh-mcp --http

Эндпоинт: http://localhost:3000/mcp (POST) · Проверка состояния: http://localhost:3000/health (GET)

HTTP-режим stateless, по умолчанию слушает 127.0.0.1 с включённой защитой от DNS-rebinding. Чтобы открыть его наружу, задайте HOST=0.0.0.0, добавьте свой host/origin в HH_ALLOWED_HOSTS / HH_ALLOWED_ORIGINS и поставьте перед ним собственную аутентификацию.

Переменные окружения

ПеременнаяОбяз.Описание
HH_ACCESS_TOKENнетBearer-токен OAuth 2.0. Нужен для эндпоинтов резюме (работодатель + оплаченная база резюме).
HH_USER_AGENTнетСвой HH-User-Agent (hh.ru его требует). Рекомендуемый формат: your-app/1.0 ([email protected]).
HTTP_PORT / PORTнетПорт HTTP-режима (по умолчанию 3000).
HOSTнетИнтерфейс привязки в HTTP-режиме (по умолчанию 127.0.0.1).
HH_ALLOWED_HOSTSнетСписок разрешённых Host через запятую для HTTP-режима (по умолчанию loopback).
HH_ALLOWED_ORIGINSнетСписок разрешённых Origin через запятую для HTTP-режима.

См. .env.example.

Инструменты (19)

Любой инструмент поиска или карточки принимает raw: true — тогда вернётся полный JSON hh.ru вместо компактной сводки.

Вакансии

ИнструментОписаниеТокен?
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 — название)нет
get_areas_subtreeРегионы и города внутри одного региона — легче, чем всё деревонет
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), и показать роль аккаунтанет

Ограничение частоты запросов

Встроенный лимитер соблюдает ограничение API hh.ru — 5 запросов в секунду. Автоматический повтор с экспоненциальной задержкой на ошибках 429 и 5xx (до 3 попыток). Учтите: лимитер общий на процесс, поэтому в общем HTTP-режиме все клиенты делят один бюджет 5 запросов/сек.

Демо-промпты

Найди удалённые вакансии Python-разработчика в Москве от 300 000 рублей
Покажи все открытые вакансии Яндекса и дай статистику зарплат по основным ролям
Сравни зарплаты Senior Backend в Москве и Санкт-Петербурге и предложи вакансии, похожие на самую высокооплачиваемую

Разработка

bash
git clone https://github.com/theYahia/hh-mcp.gitcd hh-mcpnpm installnpm run buildnpm test

Справочник API

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

来源：README.md，提交 1091209

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分