@theyahia/hh-mcp

MCP-сервер для hh.ru: поиск вакансий, резюме, зарплаты, работодатели, справочники. 8 инструментов.

Часть серии Russian API MCP (50 серверов) by @theYahia.

Два режима работы

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

Получить токен: dev.hh.ru/admin

Установка

Claude Desktop

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "your-token-here (опционально)"
      }
    }
  }
}

Claude Code

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

{ "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
# или
HTTP_PORT=8080 npx @theyahia/hh-mcp --http

Эндпоинт: http://localhost:3000/mcp Health check: http://localhost:3000/health

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

Инструмент	Описание	Нужен токен?
`search_vacancies`	Поиск вакансий по словам, региону, зарплате, опыту	Нет
`get_vacancy`	Полная информация о вакансии с описанием и контактами	Нет
`search_resumes`	Поиск резюме по ключевым словам и параметрам	Да
`get_resume`	Полная информация о резюме	Да
`get_employers`	Поиск работодателей по названию	Нет
`get_salary_stats`	Статистика зарплат по специальности и региону	Нет
`get_areas`	Справочник регионов РФ и СНГ с кодами	Нет
`get_professional_roles`	Справочник профессиональных ролей	Нет

Примеры

Найди вакансии Python в Москве от 200К
Покажи вакансии в Яндексе
Средняя зарплата Senior Backend?
Какие регионы есть в hh.ru?
Найди резюме Java-разработчиков в Петербурге

API

Все публичные эндпоинты используют https://api.hh.ru без авторизации. Эндпоинты резюме требуют OAuth 2.0 токен через переменную окружения HH_ACCESS_TOKEN.

User-Agent: theYahia-hh-mcp/1.0

Разработка

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

Часть серии Russian API MCP

50 серверов: github.com/theYahia/russian-mcp

Лицензия

MIT

hh-mcp

Quick Install