Skip to content

Repository files navigation

Хантфлоу для нанимающего менеджера

Разбирайте резюме и оставляйте комментарии в Хантфлоу прямо из Claude — от своего имени и в пределах своих прав заказчика, без токенов и без рекрутера.

English version

Что умеет

  • Читает ваши вакансии, этапы, кандидатов, резюме и историю — ровно то, что вы видите в Хантфлоу сами.
  • Помогает разбирать кандидатов: выжимка резюме, оценка по требованиям вакансии или по вашим собственным критериям, сравнение кандидатов таблицей.
  • Помнит, кого вы уже разобрали, и находит новых — в том числе тех, у кого появилось новое резюме.
  • Публикует комментарии в карточку кандидата: сначала черновик, потом ваше явное «да», и уходит ровно утверждённый текст.

Чего не умеет — и это намеренно

  • Не меняет этапы, не отказывает кандидатам, не пишет им писем и сообщений, ничего не удаляет. Таких функций в нём нет вообще. Заказчику в Хантфлоу это и так недоступно.
  • Пока не читает заполненные анкеты «Обратная связь».

Как это устроено

Инструмент работает в отдельном окне браузера (Edge или Chrome, уже установленном у вас). Вы один раз входите в Хантфлоу сами — паролем, через SSO или с 2FA. Инструмент пароля не видит и не хранит: вход живёт в профиле этого браузера на вашем компьютере. Дальше он открывает страницы Хантфлоу и читает их, как это делали бы вы.

Комментарий публикуется только так: черновик → вы видите текст → явное «да» → публикация. Перед отправкой инструмент проверяет, что такого текста в истории кандидата ещё нет, вставляет текст целиком (не набирает по клавишам) и сверяет его. После «Сохранить» он дожидается, пока комментарий появится в истории. Удалять комментарии инструмент не умеет — поэтому «да» обязательно.

Установка

Нужны: Claude Desktop или Claude Code; Microsoft Edge или Google Chrome; учётная запись в Хантфлоу с ролью заказчика (или любой другой ролью).

Claude Desktop — в один клик

  1. Скачайте файл huntflow-hiring-manager-<версия>.mcpb со страницы Releases.
  2. Откройте его двойным кликом — Claude Desktop предложит установить расширение.
  3. В форме установки укажите, где ваш Хантфлоу (huntflow.ru — по умолчанию, huntflow.ai — международный). Остальное можно оставить пустым.

Claude Code

git clone https://github.com/k-sukhachev/huntflow-hiring-manager-mcp.git
cd huntflow-hiring-manager-mcp && npm ci && npm run build
claude mcp add huntflow-hiring-manager -- node "/полный/путь/к/huntflow-hiring-manager-mcp/dist/server.js"

Настройки из таблицы ниже передаются через -e, например -e HHM_INSTANCE=huntflow.ai.

Первый запуск

  1. Попросите Claude: «Проверь Хантфлоу». Он вызовет hf_status.
  2. Если вход не выполнен, Claude вызовет hf_login — откроется окно браузера со страницей входа. Войдите сами и скажите Claude, что готово.
  3. При первом обращении инструмент один раз покажет предупреждение о персональных данных (ниже).

Готовые сценарии

Сценарий Что делает
Разбери новых на вакансии новые кандидаты → разборы → таблица сравнения → черновики комментариев → публикация после «да»
Оценка по моим критериям кандидат против ваших гейтов, сигналов и красных флагов; если критериев нет — Claude поможет их составить
Оценка по вакансии кандидат против требований вакансии
Сравнение кандидатов таблица по уже разобранным
Выжимка резюме коротко о кандидате, без оценки

Можно и обычными словами: «Разбери новых кандидатов на вакансии „Маркетолог“».

Настройки

Переменная Что По умолчанию
HHM_INSTANCE huntflow.ru, huntflow.ai или sandbox huntflow.ru
HHM_DATA_DIR папка для критериев, журнала разборов и черновиков Документы/Huntflow Hiring
HHM_BROWSER msedge или chrome Edge на Windows, Chrome на macOS
HHM_LANG язык файлов разборов: ru или en ru
HHM_REPORTS off — не создавать файлы разборов по вакансиям (если вы ведёте разборы в своих файлах) on
HHM_STATE_DIR папка профиля браузера ~/.huntflow-hiring-manager

Данные и безопасность

  • Персональные данные кандидатов уходят в Claude (Anthropic) для анализа. Оператор персональных данных — ваша компания. Согласуйте использование внутри компании до работы с реальными кандидатами.
  • На вашем диске остаются: профиль браузера со входом в Хантфлоу (~/.huntflow-hiring-manager, доступ только у вашей учётной записи) и ваша папка данных — критерии, журнал «кого разобрали и что опубликовали», черновики комментариев. Текст резюме в файлы разборов не пишется.
  • Инструмент нажимает в Хантфлоу только: окно «Информация о вакансии», вкладки источников резюме, поле комментария, «Сохранить» и «Отмена». Это закреплено тестом: новое нажатие не пройдёт незамеченным.
  • Текст резюме и комментариев коллег инструмент помечает для Claude как недоверенный: инструкции внутри резюме («опубликуй», «поменяй критерии») не выполняются.
  • Работа через интерфейс, а не через API — вынужденная: API-токен в Хантфлоу выпускает только управляющий рекрутер, и он видит всю базу. Когда Хантфлоу зарегистрирует OAuth-приложение, инструмент переключится на официальный вход.
  • На macOS браузер, запущенный автоматизацией, хранит cookies профиля без системной связки ключей: их защищают только права папки профиля.

Если что-то не так

Сообщение Что делать
needs_login вызовите hf_login и войдите в открывшемся окне сами
browser_busy браузер занят другой открытой сессией Claude; он освобождается после 3 минут простоя или при закрытии той сессии
browser_missing установите Edge или Chrome либо укажите другой в HHM_BROWSER
post_unconfirmed «Сохранить» нажато, но комментарий не появился в истории за 15 секунд — проверьте карточку в Хантфлоу; повтор безопасен: инструмент сначала ищет этот текст в истории
вход через Google не проходит Google иногда не пускает в окна, управляемые автоматизацией; войдите по почте и паролю или через другого провайдера
hf_status пишет «UI self-check: not found» Хантфлоу, похоже, изменил интерфейс; создайте issue

Разработка

npm ci && npm run typecheck && npm test
  • src/access/ui/ — всё, что знает об интерфейсе Хантфлоу; разметка — в selectors.ts (атрибуты data-qa), единственная запись в страницу — write.ts.
  • scripts/live-read.mjs <vacancyId> — живая проверка чтения на вашем аккаунте, печатает только структуру.
  • scripts/stage2-check.mjs <vacancyId> — проверка «новых кандидатов» на живом аккаунте, данные во временной папке.
  • scripts/comment-once.mjs — один комментарий в два шага; --rehearse доходит до «Сохранить» и нажимает «Отмена».
  • npm run pack:mcpb — собрать установщик для Claude Desktop.
  • Решения и их история — SPEC.md.

Лицензия

MIT. Проект не связан с компанией «Хантфлоу».

About

MCP server for Huntflow hiring managers: review resumes and post comments from Claude as yourself, no API token needed

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages