hh-apply-suite: сопроводительное письмо для hh.ru
hh-apply-suite
MCP-сервер, который парсит вакансию с hh.ru, изучает GitHub кандидата, пишет сопроводительное на 150-220 слов и готовит ответы на 12 типовых вопросов HR
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только готовит текст письма и ответы, отклик на вакансию отправляет сам пользователь
- Читает публичные данные вакансии и GitHub, не трогает аккаунт hh.ru
Установка
Ручная установка
git clone https://github.com/shekelstrong/hh-apply-suite.git && cd hh-apply-suite && pip install -r requirements.txtУстановка из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пять инструментов выстроены в пайплайн: parse_vacancy разбирает вакансию по официальному API hh.ru с откатом на разбор HTML, если API недоступен, и возвращает название, компанию, зарплату, требования и ATS-ключевики. research_github сортирует репозитории кандидата по звездам и совпадению с ключевыми словами вакансии и возвращает топ-10. write_cover собирает сопроводительное письмо по шаблону под роль (frontend, backend, ai, pm, fullstack) объемом 150-220 слов, с 4-5 буллетами с метриками и без клише вроде «большой опыт» и «стремлюсь». answer_hr выдает заготовленный ответ на один из 12 типов вопросов HR: график, готовность к переезду, причина ухода, зарплата и другие. ats_check проверяет черновик письма на длину, долю найденных ATS-ключевиков, запрещенные фразы, наличие метрик в буллетах и формат подписи. Инструмента отправки отклика в наборе нет: письмо и ответы готовятся, а откликается пользователь сам.
Для кого. Для соискателей, которые сами решают, куда и когда откликаться, но хотят готовый черновик сопроводительного письма и ответов HR под конкретную вакансию hh.ru.
Подходит, если
- Нужно быстро собрать сопроводительное письмо под вакансию hh.ru с учетом своего GitHub-профиля
- Нужны заготовленные ответы на типовые вопросы HR о графике, переезде, причине смены работы
- Нужна проверка письма на длину, клише и совпадение с ATS-ключевиками перед отправкой
Не подходит, если
- Нужно, чтобы инструмент сам отправил отклик: в наборе нет такого инструмента, только подготовка текста
- Ответы answer_hr нужны на нестандартный вопрос: 12 категорий покрывают только типовые темы, для остального есть generic fallback
- Не хотите передавать свой GitHub-логин для автоматического анализа репозиториев
Пример запроса к агенту
Вот вакансия hh.ru/vacancy/123456, напиши сопроводительное с учетом моего GitHub vasiliy-devОграничения
Проект от одного автора, README отражает голос и стиль конкретного кандидата (Василия Недопекина), шаблоны писем стоит адаптировать под себя. Без GITHUB_TOKEN лимит запросов к GitHub API падает до 60 в час вместо 5000. Парсинг вакансии по HTML это запасной путь на случай недоступности официального API и может сломаться при смене верстки hh.ru.
Как отключить. Удалите сервер hh-apply-suite из конфигурации MCP клиента и локальную копию репозитория.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| GITHUB_TOKEN секрет | Повышает лимит запросов к GitHub API с 60 до 5000 в час для research_github. |
Проверка безопасности
- Только готовит текст письма и ответы, отклик на вакансию отправляет сам пользователь
- Читает публичные данные вакансии и GitHub, не трогает аккаунт hh.ru
Коротко о README
README описывает пять MCP-инструментов пайплайна отклика на hh.ru с примерами вызова каждого, структуру проекта и подробные стилевые правила для сопроводительного письма: объем 150-220 слов, один вариант, буллеты с метриками, запрет на воду и определенный формат подписи. SKILL.md добавляет таблицу типичных ошибок и их причин и список из четырех внутренних скиллов-источников. Лицензия MIT.
Частые вопросы
Отправляет ли сервер отклик за меня?
Нет, в наборе только пять инструментов подготовки текста, кнопку «откликнуться» на hh.ru нажимает пользователь сам.
Что если GitHub-профиль пустой или недоступен?
research_github вернет то, что найдет по API GitHub, но без GITHUB_TOKEN лимит запросов ограничен 60 в час.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI