Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/hh-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@theyahia/hh-mcp

MCP-сервер для API hh.ru — рынок труда России и СНГ. 19 инструментов, покрывающих вакансии, резюме, работодателей, статистику зарплат, справочники, автодополнение и диагностику токенов.

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

npm CI License: MIT

Часть серии Russian API MCP от @theYahia.

Два режима

Режим

Что доступно

Нужен ли токен?

Без токена

Поиск вакансий, вакансия по 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-rebinding. Чтобы открыть доступ, установите HOST=0.0.0.0 и добавьте ваш хост/origin в 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

Нет

Разрешённый список 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 — name)

Нет

get_areas_subtree

Регионы/города внутри одного area 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), и вывод роли аккаунта

Нет

Ограничение скорости

Встроенный ограничитель скорости соблюдает лимит API hh.ru — 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