hh.ru MCP: Документация
Обновлено:
Подключение
npx -y @theyahia/hh-mcp (stdio) или npx @theyahia/hh-mcp --http (порт из HTTP_PORT/PORT, биндится на 127.0.0.1). Без токена доступны вакансии и статистика; с HH_ACCESS_TOKEN (получить на dev.hh.ru/admin) — ещё и резюме, но поиск резюме дополнительно требует аккаунт работодателя с платной подпиской на базу резюме (иначе 403).
Что умеет
19 инструментов: вакансии (search_vacancies, get_vacancy, get_similar_vacancies), резюме (search_resumes, get_resume — только с токеном), работодатели (search_employers, get_employer, get_employer_vacancies), справочники и автодополнение (get_areas/get_areas_subtree, get_professional_roles, get_industries, get_metro, get_dictionaries, suggest_positions/suggest_companies/suggest_areas), зарплаты и аккаунт (get_salary_statistics, validate_token). Любой поисковый/детальный инструмент принимает raw: true для полного JSON hh.ru.
Сценарий для агента
«Какая вилка у Go-разработчиков в Питере?», «собери вакансии Яндекса и сравни требования», «сравни зарплаты Senior Backend в Москве и Питере».
Важно
Community-проект (theYahia), не официальный продукт HeadHunter. get_salary_statistics — оценка по опубликованным вакансиям, не официальные данные рынка.