v2: язык не критичен (Python и TS оба ок) → переоценен fork-target. Приоритет — MVP: быстрый старт, минимум доработок. mardanaltynbekov поднимается из «inspiration» в top-pick.
В условиях «язык не критичен + MVP-приоритет» этот проект побеждает gmen1057 по всем ключевым осям.
Главный риск: v0.1.1, 2 коммита, 0 stars — bus factor 1 как и везде. Mitigation — fork-and-own.
| Проект | Lang | Side | Подход | Tools | Транспорт | Lic | Status | ★ | Last |
|---|---|---|---|---|---|---|---|---|---|
| mardanaltynbekov1104/ hh-mcp 🏆 |
TS | employer | direct API, multi-site | 9 / 70+ | stdio + HTTP | MIT | very fresh | 0 | 6 дн |
| gmen1057/ headhunter-mcp-server |
Python | both | direct API | 10 | stdio | MIT | active | 14 | 8 commits |
| sargonpiraev/ hh-mcp-server |
TS | both | OAuth facade + PKCE, codegen | 167+ | HTTP + stdio | MIT | archived 23.04.26 | 4 | v1.22.0 |
| Vadtop/ hh-mcp-server |
Python | job-seeker | Playwright | 20 (60 tests) | stdio + HTTP | MIT | active | 1 | 29 дн |
| iraguzov/ hh-mcp-server |
Python | job-seeker | Playwright | 7 | stdio | не указана | slow | 3 | 9 апр |
| jacintacaryophyllaceous404/ hh-ru-apply |
JS | job-seeker | Playwright + LLM scoring | ? | ? | ? | very fresh | 0 | 7 ч |
| Obure22/ SecondHackaton-HackAI |
Python | both | hackathon | ? | ? | ? | hackathon | 0 | 12.12.25 |
Тёмно-зелёная заливка — top pick (mardanaltynbekov). Светло-зелёная — strong runner-up (gmen1057).
Используют официальный HH API. Применимы для employer-сценариев. Оба MIT, можно форкать.
OAuth facade с PKCE, codegen из OpenAPI, можно деплоить как SaaS.
Появились после закрытия job-seeker API 15.12.2025. Серая зона — нарушают ToS HH. Технически возможны, но три слоя риска (ToS / 152-ФЗ / ATS-репутация).
Tools: hh_auth, hh_dictionaries, hh_suggests, hh_salary, hh_employer_info, hh_employer_vacancies, hh_employer_negotiations, hh_employer_resumes, hh_webhooks. Каждый — group-tool с action-параметром.
План MVP: форкаем → проверяем что все 9 tools работают → добавляем недостающее (например, saved_searches если нужно) → пишем README с onboarding-инструкцией → public release.
Простой Python MCP с 10 ручными tools. ~400 строк кода в 2 файлах — за час читается полностью.
letter → messageКогда выбирать: только если Python — жёсткое требование команды/инфраструктуры. Иначе mardanaltynbekov даёт больше из коробки.
Production-grade. Полный OAuth 2.0 facade: /oauth/authorize, /oauth/token, /oauth/register (Dynamic Client Registration RFC 7591), PKCE. Multi-tenant через Mcp-Session-Id header. Streamable HTTP transport. 167+ tools codegen'нуты из OpenAPI.
Когда выбирать: если в roadmap есть SaaS / multi-tenant — копируем OAuth facade pattern. Для MVP — пропускаем.
Наиболее зрелый Playwright-based MCP. Anti-bot stealth: UA spoofing, randomized viewports, anti-bot delays, persistent cookies в .browser_session/. TF-IDF scoring в hh_score_vacancy (0-100). SQLite applied.db предотвращает повторные отклики.
Не для нашего scope — job-seeker only, серая зона. Включён для landscape-полноты.
Компактная Playwright-реализация. Slim слоистая архитектура. Sessions в ~/.hh-mcp/profile/state.json.
Лицензия не указана — fork нельзя; только для inspiration / понимания паттерна слоистой архитектуры.
Автоматизация поиска вакансий с LLM-скорингом и браузерными приложениями. Технические детали пока не задокументированы.
Хакатонный проект декабря 2025 — mcp-server+agent hh.ru helper vacancies. Не для production. Включён в landscape для полноты картины.
| Приоритет / условие | Рекомендация |
|---|---|
| MVP, employer scope, язык не критичен (наш кейс) | 🏆 Fork mardanaltynbekov1104/hh-mcp — максимум готового из коробки |
| Жёсткое требование Python в команде/инфре | Fork gmen1057 + добавить недостающее (multi-site, refresh, webhooks) |
| SaaS / multi-tenant для нескольких работодателей | Fork sargonpiraev — OAuth facade + PKCE готовы (archived → fork-and-own) |
| Нужно покрытие всего HH OpenAPI (все 167 endpoints) | Fork sargonpiraev — единственный с полным coverage через codegen |
| Job-seeker automation (с принятием рисков) | Vadtop/hh-mcp-server — самый зрелый Playwright-проект |
| Только аналитика рынка (read-only, без авторизации) | Anonymous endpoints HH OpenAPI напрямую — даже MCP не нужен |
| Learning / inspiration без коммита к коду | Читать sargonpiraev (production patterns) + mardanaltynbekov (clean architecture) |
| Что нужно для employer MVP | mardanaltynbekov | gmen1057 |
|---|---|---|
| Employer-only tools (без job-seeker мусора) | ✅ из коробки | ❌ нужно резать |
| OAuth refresh-flow | ✅ auto на 401 | ❌ нужно дописать |
| Multi-site (hh.kz/hh.ru) | ✅ через ENV | ❌ нет |
| Webhooks tool | ✅ hh_webhooks | ❌ нет |
| Группировка tools (clean API для Claude) | ✅ 9 group-tools | ❌ 10 плоских |
| Token storage паттерн | ✅ ~/.hh-mcp/tokens.json | ❌ только env |
| Распространение через package manager | ✅ npm path готов | ❌ нет PyPI |
| Известный баг с параметром (#5) | — | ❌ letter → message |
При MVP-приоритете «меньше доработок = лучше» mardanaltynbekov выигрывает 7:0 (один счёт ничейный по «нет multi-site, потому что у gmen1057 его тоже нет»).
| Альтернатива | Что это | Когда выбирать |
|---|---|---|
| Apify scrapers | SaaS HTML-парсеры с MCP-endpoint поверх | Read-only массовый сбор; готовы платить и принимать ToS-нарушение |
| Career-Ops (Claude Code Skills) | Skills + WebFetch без MCP-сервера | Advisor-сценарии, не специфично HH |
| s3rgeym/hh-applicant-tool | CLI tool с hybrid API + UI emulation | Личное использование, non-commercial license |
| Свой клиент поверх OpenAPI | Генерация Python/TS-клиента через openapi-generator-cli |
Full control, production employer-интеграция |
Что умеет внутренний AI-ассистент HH:
Это не MCP, а proprietary B2B-фича внутри платформы HH. Но архитектурно перекрывает значительную часть того, что делают сторонние MCP-серверы в employer-сегменте.
Что это значит для нашего проекта: дифференцироваться через кастомные workflow, multi-site (rabota.by/hh.kz), интеграции с внешними системами (CRM, Telegram, аналитика), полный контроль recruiter'а над action'ами. Не пытаться повторить то что HH делает глубже через internal-доступ.