hh.ru MCP

theYahia/hh-mcp· Проверено 12.11.2026· 10на GitHub

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

2 реализации:

19 инструментов, ставится через npx; поиск вакансий, работодатели, справочники и оценка зарплат работают без токена, поиск резюме — с токеном работодателя.

Как подключить

Что сделать до подключения

Node.js с npx

HH_ACCESS_TOKEN

необязательно: выдаётся на dev.hh.ru/admin; для поиска резюме нужен аккаунт работодателя с оплаченной подпиской на базу резюме

HH_USER_AGENT

необязательно: свой HH-User-Agent вида your-app/1.0 (you@example.com)

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'HH_ACCESS_TOKEN=<OAuth-токен hh.ru, необязательно>' --transport stdio hh \
  -- npx -y @theyahia/hh-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.hh]
command = "npx"
args = ["-y", "@theyahia/hh-mcp"]

[mcp_servers.hh.env]
HH_ACCESS_TOKEN = "<OAuth-токен hh.ru, необязательно>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "hh": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "hh": {
        "type": "local",
        "command": ["npx", "-y", "@theyahia/hh-mcp"],
        "environment": {
          "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "<OAuth-токен hh.ru, необязательно>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

search_vacanciesищет вакансии с фильтрами

get_vacancyоткрывает карточку вакансии

get_similar_vacanciesнаходит похожие вакансии

search_employersищет компании

get_employerпоказывает профиль работодателя

get_employer_vacanciesперечисляет вакансии компании

get_salary_statisticsоценивает зарплаты по роли и региону

search_resumesищет резюме кандидатов

get_resumeоткрывает резюме

get_areasвыдаёт дерево регионов

get_professional_rolesвыдаёт профессиональные роли

get_industriesвыдаёт отрасли

get_metroвыдаёт станции метро

get_dictionariesвыдаёт справочники

suggest_positionsподсказывает должности

validate_tokenпроверяет токен и роль аккаунта

Показано 16 из 19.

10 инструментов на Python для соискателя: кроме поиска показывает ваши резюме, историю откликов и откликается с сопроводительным письмом; ставится клонированием репозитория.

Как подключить

Что сделать до подключения

Python 3.10 или новее; склонировать репозиторий, создать venv и выполнить pip install -r requirements.txt

Приложение, зарегистрированное на dev.hh.ru/admin

Для откликов и резюме: python examples/oauth_flow.py, он сохранит HH_ACCESS_TOKEN и HH_REFRESH_TOKEN в .env

HH_CLIENT_ID

dev.hh.ru/admin → ваше приложение

HH_CLIENT_SECRET

dev.hh.ru/admin → ваше приложение

HH_APP_TOKEN

dev.hh.ru/admin → ваше приложение

HH_REDIRECT_URI

адрес возврата, указанный в приложении

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'HH_CLIENT_ID=<Client ID>' --env 'HH_CLIENT_SECRET=<Client Secret>' --env 'HH_APP_TOKEN=<App Token>' --env 'HH_REDIRECT_URI=<redirect URI приложения>' --transport stdio headhunter-mcp-server \
  -- /path/to/venv/bin/python /path/to/headhunter-mcp-server/server.py

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.headhunter-mcp-server]
command = "/path/to/venv/bin/python"
args = ["/path/to/headhunter-mcp-server/server.py"]

[mcp_servers.headhunter-mcp-server.env]
HH_CLIENT_ID = "<Client ID>"
HH_CLIENT_SECRET = "<Client Secret>"
HH_APP_TOKEN = "<App Token>"
HH_REDIRECT_URI = "<redirect URI приложения>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "headhunter-mcp-server": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "<Client ID>",
        "HH_CLIENT_SECRET": "<Client Secret>",
        "HH_APP_TOKEN": "<App Token>",
        "HH_REDIRECT_URI": "<redirect URI приложения>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "headhunter-mcp-server": {
      "type": "stdio",
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "<Client ID>",
        "HH_CLIENT_SECRET": "<Client Secret>",
        "HH_APP_TOKEN": "<App Token>",
        "HH_REDIRECT_URI": "<redirect URI приложения>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "headhunter-mcp-server": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "<Client ID>",
        "HH_CLIENT_SECRET": "<Client Secret>",
        "HH_APP_TOKEN": "<App Token>",
        "HH_REDIRECT_URI": "<redirect URI приложения>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "headhunter-mcp-server": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "<Client ID>",
        "HH_CLIENT_SECRET": "<Client Secret>",
        "HH_APP_TOKEN": "<App Token>",
        "HH_REDIRECT_URI": "<redirect URI приложения>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "headhunter-mcp-server": {
        "type": "local",
        "command": [
          "/path/to/venv/bin/python",
          "/path/to/headhunter-mcp-server/server.py"
        ],
        "environment": {
          "HH_CLIENT_ID": "<Client ID>",
          "HH_CLIENT_SECRET": "<Client Secret>",
          "HH_APP_TOKEN": "<App Token>",
          "HH_REDIRECT_URI": "<redirect URI приложения>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "headhunter-mcp-server": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "<Client ID>",
        "HH_CLIENT_SECRET": "<Client Secret>",
        "HH_APP_TOKEN": "<App Token>",
        "HH_REDIRECT_URI": "<redirect URI приложения>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "headhunter-mcp-server": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "<Client ID>",
        "HH_CLIENT_SECRET": "<Client Secret>",
        "HH_APP_TOKEN": "<App Token>",
        "HH_REDIRECT_URI": "<redirect URI приложения>"
      }
    }
  }
}

Инструменты сервера

hh_search_vacanciesищет вакансии с фильтрами

hh_get_vacancyоткрывает карточку вакансии

hh_get_employerпоказывает данные компании

hh_get_similarнаходит похожие вакансии

hh_get_areasвыдаёт регионы и города

hh_get_dictionariesвыдаёт справочники

hh_get_resumesперечисляет ваши резюме

hh_get_resumeоткрывает ваше резюме

hh_apply_to_vacancyоткликается на вакансию

hh_get_negotiationsпоказывает историю откликов

Что попросить агента

«Найди удалённые вакансии <профессия> в <город> от <сумма> рублей»Агент вызовет search_vacancies с фильтрами по региону, зарплате и формату работы, во втором варианте — hh_search_vacancies

«Покажи все открытые вакансии <компания> и дай статистику зарплат по основным ролям»Агент вызовет search_employers, get_employer_vacancies и get_salary_statistics

«Сравни зарплаты <должность> в Москве и Санкт-Петербурге и предложи вакансии, похожие на самую высокооплачиваемую»Агент вызовет get_salary_statistics по двум регионам, затем get_similar_vacancies

«Покажи мои резюме»Во втором варианте агент вызовет hh_get_resumes

«Откликнись на вакансию <ID вакансии> резюме <ID резюме> с письмом: «<текст>»»Во втором варианте агент вызовет hh_apply_to_vacancy

Для каких задач

Найти удалённые вакансии по профессии в нужном городе от заданной зарплаты

Показать все открытые вакансии компании

Сравнить оценку зарплат по роли в Москве и Санкт-Петербурге

Подобрать вакансии, похожие на понравившуюся

Откликнуться на вакансию с вашим резюме и сопроводительным письмом

Ограничения

Поиск резюме в @theyahia/hh-mcp требует аккаунта работодателя с оплаченной подпиской на базу резюме; токены соискателя и анонимные получают 403

Статистика зарплат в @theyahia/hh-mcp — оценка по зарплатам опубликованных вакансий: выборка смещённая, это не данные рынка

API hh.ru пропускает 5 запросов в секунду; в общем HTTP-режиме @theyahia/hh-mcp все клиенты делят этот лимит

hh_apply_to_vacancy отправляет отклик от вашего имени; для откликов и резюме нужна авторизация OAuth через examples/oauth_flow.py

Если не работает

search_resumes или get_resume отвечает 403

Токен соискателя или его нет. Поиск резюме работает только с токеном работодателя с оплаченной базой резюме; роль аккаунта покажет validate_token.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
@theyahia/hh-mcp	theYahia	10	локально	не нужен	19	6 сентября 2026
HeadHunter MCP Server	gmen1057	39	локально	вход	10	13 октября 2025

Частые вопросы

Нужен ли токен hh.ru?

Для @theyahia/hh-mcp — нет: поиск вакансий, работодатели, справочники и зарплаты работают без него. Токен HH_ACCESS_TOKEN нужен для поиска резюме. Второму варианту нужны Client ID, Client Secret и App Token приложения с dev.hh.ru/admin.

Какой вариант выбрать соискателю?

Откликаться на вакансии и смотреть историю откликов умеет только HeadHunter MCP Server: hh_apply_to_vacancy и hh_get_negotiations работают после авторизации OAuth. @theyahia/hh-mcp шире в поиске: метро, отрасли, роли, подсказки и оценка зарплат.

Как получить полный ответ hh.ru вместо сводки?

В @theyahia/hh-mcp передайте raw: true любому инструменту поиска или карточки, вернётся полный JSON hh.ru. По умолчанию ответы приходят компактными сводками.

Можно запустить @theyahia/hh-mcp по HTTP?

Да: npx @theyahia/hh-mcp --http, эндпоинт http://localhost:3000/mcp. По умолчанию сервер слушает только 127.0.0.1; чтобы открыть наружу, задайте HOST=0.0.0.0, разрешённые HH_ALLOWED_HOSTS и HH_ALLOWED_ORIGINS и поставьте перед ним свою аутентификацию.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и обращаются к API hh.ru напрямую; зарубежные аккаунты не нужны.

hh.ru MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы