theyahia avatar

Hh Mcp

theyahia/hh-mcp

Connects Claude to hh.ru, the major job platform for Russia and CIS markets. Exposes 16 tools covering vacancy search with filters for salary, region, and experience, plus employer lookups, salary statistics by professional role, and autocomplete for positions and companies. Works without auth for most operations. Add an OAuth token to unlock resume search and detailed candidate profiles. Handles rate limiting automatically at 5 requests per second with retry logic. Useful if you're building job search agents, compensation research tools, or recruitment workflows targeting Russian-speaking markets. Part of a broader Russian API MCP series.

tools
19
auth
Secret needed
transport
STDIO
env var
1
last updated
Mar 31, 2026

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

search_vacanciesПоиск по ключевым словам, региону, профессиональной роли, отрасли, метро, работодателю, зарплате, опыту, формату работы и типу занятости, периоду, меткам и полю поиска, с сортировкой и пагинацией

Поиск по ключевым словам, региону, профессиональной роли, отрасли, метро, работодателю, зарплате, опыту, формату работы и типу занятости, периоду, меткам и полю поиска, с сортировкой и пагинацией

No parameter schema in public metadata yet.

get_vacancyПолная карточка вакансии: описание, требования, ключевые навыки, контакты

Полная карточка вакансии: описание, требования, ключевые навыки, контакты

No parameter schema in public metadata yet.

get_similar_vacanciesНайти вакансии, похожие на заданную

Найти вакансии, похожие на заданную

No parameter schema in public metadata yet.

search_resumesПоиск резюме кандидатов по ключевым словам, региону, роли, зарплате, опыту

Поиск резюме кандидатов по ключевым словам, региону, роли, зарплате, опыту

No parameter schema in public metadata yet.

get_resumeПолное резюме: опыт, образование, навыки, контакты

Полное резюме: опыт, образование, навыки, контакты

No parameter schema in public metadata yet.

search_employersПоиск компаний по названию и региону

Поиск компаний по названию и региону

No parameter schema in public metadata yet.

get_employerПрофиль работодателя: описание, отрасли, сайт, число вакансий

Профиль работодателя: описание, отрасли, сайт, число вакансий

No parameter schema in public metadata yet.

get_employer_vacanciesАктивные вакансии конкретного работодателя

Активные вакансии конкретного работодателя

No parameter schema in public metadata yet.

get_areasДерево регионов и городов (id — название)

Дерево регионов и городов (id — название)

No parameter schema in public metadata yet.

get_areas_subtreeРегионы и города внутри одного региона — легче, чем всё дерево

Регионы и города внутри одного региона — легче, чем всё дерево

No parameter schema in public metadata yet.

get_professional_rolesДерево профессиональных ролей с ID

Дерево профессиональных ролей с ID

No parameter schema in public metadata yet.

get_industriesДерево отраслей компаний с ID

Дерево отраслей компаний с ID

No parameter schema in public metadata yet.

get_metroСтанции и линии метро с ID по городу

Станции и линии метро с ID по городу

No parameter schema in public metadata yet.

get_dictionariesВсе справочные данные: валюты, типы занятости, графики, опыт, метки

Все справочные данные: валюты, типы занятости, графики, опыт, метки

No parameter schema in public metadata yet.

suggest_positionsАвтодополнение названий должностей

Автодополнение названий должностей

No parameter schema in public metadata yet.

suggest_companiesАвтодополнение названий компаний

Автодополнение названий компаний

No parameter schema in public metadata yet.

suggest_areasАвтодополнение названий регионов и городов

Автодополнение названий регионов и городов

No parameter schema in public metadata yet.

get_salary_statisticsОценочное распределение зарплат (медиана, P25/P75, мин/макс) по роли в регионе, посчитанное по зарплатам опубликованных вакансий

Оценочное распределение зарплат (медиана, P25/P75, мин/макс) по роли в регионе, посчитанное по зарплатам опубликованных вакансий

No parameter schema in public metadata yet.

validate_tokenПроверить, действителен ли HH_ACCESS_TOKEN (через /me), и показать роль аккаунта

Проверить, действителен ли HH_ACCESS_TOKEN (через /me), и показать роль аккаунта

No parameter schema in public metadata yet.

Sponsors

Configuration

API_KEY*secret

API key for the service

Readme

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

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

npm CI License: MIT

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


View the full README on GitHub

Details

Repository
github.com/theyahia/hh-mcp
Category
Search & Web Crawling
Package
@theyahia/hh-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from theyahia

Related Search & Web Crawling MCP servers

View all
1theyahia avatarKontur Focus Mcptheyahia/kontur-focus-mcpMCP server for Kontur.Focus API — company search, brief reports, financial analytics, counterparty0stars
2theyahia avatarTravelpayouts Mcptheyahia/travelpayouts-mcpMCP server for Travelpayouts API -- flight search, popular routes, price calendar.0stars
3tomasbenavidez avatarallinboxtomasbenavidez/allinboxSearch all your email accounts in one query. Read-only IMAP, cannot send; optional drafts.0stars
4tooloracle avatarFlightoracletooloracle/flightoracleFlight Intelligence MCP — search, cheapest dates, multi-city, airline compare via Google Flights0stars
5tooloracle avatarHoteloracletooloracle/hoteloracleHotel Intelligence MCP — search, price compare, area guides, price calendars via Google Hotels0stars
6tooloracle avatarLawtooloracle/lawLawOracle — 20 legal AI tools: case law search, contracts, EU regulations, citation graph.0stars