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 分