HeadHunter·gmen1057
HeadHunter MCP — подключение и инструкция
HeadHunter MCP помогает агенту искать вакансии, читать данные работодателей и работать с разрешёнными функциями hh.ru API.
Что умеет этот сервер
HeadHunter MCP помогает агенту искать вакансии, читать данные работодателей и работать с разрешёнными функциями hh.ru API.
Community-сервер gmen1057 разделяет поиск и операции с резюме/откликами.
Начни с поиска по должности, региону и опыту.
Задача для знакомства
Через HeadHunter MCP найди вакансии по моим критериям и покажи требования со ссылками. Резюме не меняй и отклики не отправляй.
Уточнить результат
Сверь регион, диапазон зарплаты, валюту и актуальность вакансии. Убедись, что ссылки ведут к найденным объявлениям; оценки соответствия — гипотеза, не решение работодателя.
Как подключить
Выберите подходящий способПодключить HeadHunter MCP
Скачай настоящий репозиторий gmen1057/headhunter-mcp-server, а не шаблон yourusername из примера README. Создай venv, установи зависимости, заполни .env. Настрой запуск server.py Python-окружением и отдельный OAuth-flow для функций аккаунта.
Что понадобится
- Python 3.10+, venv, requirements.txt и приложение HeadHunter API. Подготовь собственные client ID/secret и app token по инструкции.
- 01
Подготовь окружение
Python 3.10+, venv, requirements.txt и приложение HeadHunter API. Подготовь собственные client ID/secret и app token по инструкции.
- 02
Установи и настрой
Скачай настоящий репозиторий gmen1057/headhunter-mcp-server, а не шаблон yourusername из примера README. Создай venv, установи зависимости, заполни .env. Настрой запуск server.py Python-окружением и отдельный OAuth-flow для функций аккаунта.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Пример MCP-конфигурации на основе README
{
"mcpServers": {
"headhunter": {
"type": "stdio",
"command": "/path/to/venv/bin/python",
"args": [
"/path/to/headhunter-mcp-server/server.py"
],
"env": {
"HH_CLIENT_ID": "your_client_id",
"HH_CLIENT_SECRET": "your_client_secret",
"HH_APP_TOKEN": "your_app_token",
"HH_REDIRECT_URI": "https://your-domain.com/oauth/callback"
}
}
}
}Первый запрос — пример для чата агента
Через HeadHunter MCP найди вакансии по моим критериям и покажи требования со ссылками. Резюме не меняй и отклики не отправляй.Как проверить
Сверь регион, диапазон зарплаты, валюту и актуальность вакансии. Убедись, что ссылки ведут к найденным объявлениям; оценки соответствия — гипотеза, не решение работодателя.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет HeadHunter
HeadHunter MCP помогает агенту искать вакансии, читать данные работодателей и работать с разрешёнными функциями hh.ru API.
Community-сервер gmen1057 разделяет поиск и операции с резюме/откликами. Последние требуют OAuth пользователя; наличие app credentials не даёт права откликаться от любого аккаунта.
Что подготовить перед подключением
Python 3.10+, venv, requirements.txt и приложение HeadHunter API. Подготовь собственные client ID/secret и app token по инструкции.
Как установить и подключить
Скачай настоящий репозиторий gmen1057/headhunter-mcp-server, а не шаблон yourusername из примера README. Создай venv, установи зависимости, заполни .env. Настрой запуск server.py Python-окружением и отдельный OAuth-flow для функций аккаунта.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Начни с поиска по должности, региону и опыту. Прочитай несколько вакансий и сравни требования с резюме, не отправляя отклики автоматически.
Как проверить результат и решить проблемы
Сверь регион, диапазон зарплаты, валюту и актуальность вакансии. Убедись, что ссылки ведут к найденным объявлениям; оценки соответствия — гипотеза, не решение работодателя.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Квоты и правила hh.ru API действуют отдельно. Поиск, доступ к резюме и отклик имеют разные permissions; авторизация не заменяет выбор конкретного адресата.
Исходники и документация
Репозиторий: gmen1057/headhunter-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.