HH MCP (unofficial)

⚠️ Disclaimer — This is an unofficial integration. This Actor is not affiliated with, endorsed by, or sponsored by hh.ru or its parent company. "hh.ru" / «HeadHunter» are trademarks of their respective owners. This Actor uses the public hh.ru API (https://api.hh.ru) under the publisher's own application token. You are responsible for using the data in compliance with hh.ru's API Terms of Service.

Дисклеймер — Это неофициальная интеграция. Actor не связан, не одобрен и не спонсируется компанией HeadHunter. «hh.ru» / «HeadHunter» — товарные знаки соответствующих правообладателей. Actor использует публичный API hh.ru (https://api.hh.ru) под токеном приложения издателя. Использование данных регулируется правилами API hh.ru.

Search vacancies and employers on hh.ru through AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients. Find jobs by area, salary, schedule, work format, employer, professional role; fetch full vacancy and employer descriptions; look up reference data — all through natural language.

What you can do

Vacancy search and read:

• hh_search_areas — look up area IDs by name (Москва → 1, Россия → 113)
• hh_find_vacancies — full hh.ru filter set: text, area, salary, period, schedule, work format, education, industry, employer, professional role, etc.
• hh_get_vacancy — full details by vacancy ID (description, key skills, address, contacts)
• hh_get_similar_vacancies — "more like this" for any vacancy

Employer search and read:

• hh_find_employers — search by name, area, type, vacancies count
• hh_get_employer — full employer profile (type, description, industries, site, area, IT-accreditation)

Reference data:

• hh_list_dictionaries — hh.ru reference dictionaries (experience, employment, work_format, currency, etc.)
• hh_list_professional_roles — professional roles taxonomy
• hh_list_industries — industry taxonomy
• hh_search_metro_stations — metro stations across cities

All ten tools are read-only and idempotent. The Actor exposes whatever the underlying HH MCP server provides.

Setup (1 minute)

Unlike per-user OAuth integrations, you don't need to register an hh.ru application — the Actor uses a shared application token provisioned by the publisher.

Connect from your MCP client

Once the Actor is running in standby mode, connect to:

https://<your-username>--hh-mcp.apify.actor/mcp

with the Authorization header:

Authorization: Bearer <YOUR_APIFY_API_TOKEN>

The Actor speaks Streamable HTTP MCP (POST/GET/DELETE on /mcp, session id in mcp-session-id header). Most MCP clients handle this transparently.

Claude Desktop config example

{
  "mcpServers": {
    "hh": {
      "url": "https://your-username--hh-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_API_TOKEN"
      }
    }
  }
}

Pricing

• Actor start: $0.00005 — when the Actor instance boots (cold start)
• Tool call: $0.01 — per MCP tool invocation
• List request: $0.001 — per tools/list, resources/list discovery call

Plus standard Apify compute costs (typically $0.01–0.05 per hour of standby).

Limitations

hh.ru removed applicant-side API access in December 2024. The following are not implementable through the public API and are intentionally absent from this Actor:

• listing your own resumes
• reading resume details
• finding vacancies matched to your resume
• listing your negotiations / responses
• applying to vacancies

Quote from hh.ru API support (8 May 2026): «Работа с резюме и откликами со стороны соискателя не поддерживается в нашем API с декабря прошлого года. С токеном соискателя доступен только запрос GET /me».

This Actor is for search and discovery of public vacancy and employer data, not for managing a job-seeker account.

Rate limits

The Actor shares a single hh.ru application token across all subscribers, which has aggregate rate limits. If you hit limits, requests will return 429 — wait and retry. For high-volume use cases, contact the publisher.

Support

Issues and feature requests: https://github.com/SourceSurfer/mcp-collection/issues

---

По-русски

Ищите вакансии и работодателей на hh.ru через AI-ассистентов (Claude Desktop, Cursor, другие MCP-клиенты). Поиск по городу, зарплате, графику, формату работы, работодателю, профессиональной роли; полные описания вакансий и компаний; справочные данные — голосом или текстом.

Что нужно:

1. Apify аккаунт (бесплатный план подходит)
2. Подписка на этот Actor

Регистрация в hh.ru не требуется — Actor использует общий токен приложения издателя.

Установка: подключитесь из Claude Desktop по URL Actor'а из формы выше — никаких полей заполнять не надо.

Тарификация: $0.01 за вызов tool + базовые расходы Apify на compute. Для активного использования (~100 вызовов в день) — порядка $30–60 в месяц включая Apify costs.

Ограничения: с декабря 2024 hh.ru закрыл API для соискателей. Доступен только поиск публичных вакансий и работодателей — не работа с резюме/откликами от лица соискателя.