hh-job-hunter

Поиск и отклики на hh.ru с помощью ИИ
Скачай Claude Code, открой в нём папку клона и пиши ассистенту — он запустит команды и Playwright из проекта (самому терминал не обязателен).

---

Что это

Инструменты и скилл для папки hh: подбор вакансий под резюме, фильтры, отклики через браузер (Playwright), журнал откликов. Репозиторий: github.com/fsbtactic-code/hhru. Рабочий сценарий: установить Claude Code, клонировать репозиторий, открыть корень клона в Claude Code и описывать задачу обычным языком там — ассистент подскажет команды и выполнит их в папке проекта (веб-чат без доступа к файлам репозитория сюда не подходит).

---

С чего начать (первый раз)

1. Установи Claude Code (десктопное приложение от Anthropic) и войди в аккаунт.
2. Клонируй репозиторий и открой папку hhru в Claude Code как проект (File → Open Folder или аналог).

Ниже — готовые тексты: вставь блок целиком в чат Claude Code (в открытом проекте). В промптах уже есть ссылка на https://github.com/fsbtactic-code/hhru.

1) Установка и Playwright

Промпт в Claude Code:

Склонируй репозиторий https://github.com/fsbtactic-code/hhru (ветка main, клон: https://github.com/fsbtactic-code/hhru.git). Открой корень клона (папка обычно hhru). Выполни pip install -r requirements.txt и python -m playwright install chromium. Убедись, что скилл лежит в .claude/skills/hh-job-hunter/ — как в репозитории на GitHub.

Те же шаги в терминале (после клона репозитория):

git clone https://github.com/fsbtactic-code/hhru.git
cd hhru
pip install -r requirements.txt
python -m playwright install chromium

2) Вход на hh.ru

Промпт в Claude Code:

В проекте https://github.com/fsbtactic-code/hhru (корень клона) запусти python browser_auth.py. Я войду на hh.ru в открывшемся окне браузера и закрою его после входа.

Slash-команда (если настроен Claude Code): /hh-auth

После входа сессия сохранится в .session.

3) Сопроводительное письмо

Промпт в Claude Code:

В репозитории https://github.com/fsbtactic-code/hhru сгенерируй универсальное сопроводительное письмо на русском под мои навыки и поиск работы (ниже вставлю текст резюме или ссылку на hh). Сохрани результат в cover_letter_universal.txt. Если в файле была одна строка REPLACE_ME — удали её и вставь готовое письмо.

Личное письмо без публикации в Git: в корне клона https://github.com/fsbtactic-code/hhru создай cover_letter_private.txt (файл в .gitignore) — скрипты отклика подставят его вместо шаблона из репозитория.

4) Настройки и фильтры

Промпт в Claude Code:

Настрой проект https://github.com/fsbtactic-code/hhru (hh-job-hunter): помоги заполнить hunter_config.json и filter.json под мои условия (ЗП, ключевые слова, исключения). Задай мне короткие вопросы по одному.

Slash-команда: /hh-setup

5) Проверка, что всё на месте

Промпт в Claude Code:

В репозитории https://github.com/fsbtactic-code/hhru запусти python dashboard.py и выведи краткую сводку: есть ли сессия, логи в output/, последние отклики.

Slash-команда: /hh-dashboard

6) Поиск и отклики: сколько и с какого скора

Промпт в Claude Code:

В репозитории https://github.com/fsbtactic-code/hhru сделай как /hh-start: спроси меня, на сколько вакансий откликнуться (число N для --apply) и с какого минимального скоринга отбирать для отклика (число S для --apply-min-score, по умолчанию можно предложить 40). Затем из корня клона запусти python run_hunter.py --compact --pages 2 --apply N --apply-min-score S, подставив согласованные N и S. Если нужно — уточни --skills, --resume-id, сначала прогон с --dry-run.

Slash-команда: /hh-start

7) Ручные отклики, где нужно своё письмо

Промпт в Claude Code:

В проекте https://github.com/fsbtactic-code/hhru работай как /hh-review: найди вакансии, где нужно индивидуальное сопроводительное (файлы output/cover_queue_*.json / .md, записи в output/APPLICATIONS_MASTER.md), помоги с текстом письма и откликом через apply_single.py (--url, --letter-file или --letter-text, --resume-id при необходимости).

Slash-команда: /hh-review

8) Отклики по очереди JSON (уже есть письма в файле)

Промпт в Claude Code:

В репозитории https://github.com/fsbtactic-code/hhru запусти пакетные отклики: файл очереди output/…json (в каждой строке есть url и letter). Из корня клона выполни python run_apply_batches.py --queue путь/к/файлу.json --total 20 --batch 5 (подставь реальный путь, --total / --batch по ситуации; при необходимости --resume-id). Если очереди ещё нет — сначала помоги собрать её через build_apply_queue_from_resume.py или выгрузку из run_hunter.py.

Каждый день (короткий пример)

Промпт в Claude Code:

По проекту https://github.com/fsbtactic-code/hhru найди свежие вакансии под моё резюме на hh.ru и откликнись на 10 самых подходящих; используй письмо из cover_letter_private.txt или cover_letter_universal.txt. Либо сначала уточни N и скоринг и запусти как в шаге 6 (/hh-start).

---

Удобные команды (Claude Code)

Файлы лежат в .claude/commands/ (в репозитории ровно эти пять — других slash-команд для hh нет):

Команда	Зачем
/hh-auth	Вход на hh.ru, сохранение сессии
/hh-setup	Настройка hunter_config.json и filter.json
/hh-dashboard	Статистика и пути к файлам в output/
/hh-start	Поиск + автоотклики: уточнить N откликов и порог скоринга, затем run_hunter.py
/hh-review	Разбор ручных откликов с письмом

Отдельного slash для run_apply_batches.py нет — см. шаг 8 (готовый промпт).

Основной способ — Claude Code (скачай, установи, открой папку клона). Slash-команды из .claude/commands/ рассчитаны на эту среду. Альтернатива со схожим агентом: Cursor.

---

Что где лежит

Файл / папка	Назначение
browser_auth.py	Авторизация на hh.ru
run_hunter.py	Поиск вакансий, опционально отклики
run_apply_batches.py	Отклики пачками + сверка с «Мои переговоры»
build_apply_queue_from_resume.py	Очередь из выдачи search/vacancy?resume=…
dashboard.py	Сводка по output/
hunter_config.json, filter.json	Твои настройки
output/APPLICATIONS_MASTER.md	Журнал откликов

---

Если хочешь запускать из терминала

В PowerShell сначала перейди в корень клона (после git clone папка обычно hhru): Set-Location путь\к\hhru.

cd hhru
pip install -r requirements.txt
python -m playwright install chromium
python browser_auth.py
python run_hunter.py --compact --pages 2
python run_apply_batches.py --queue output/queue_from_resume.json --total 20 --batch 5
python dashboard.py

---

Чуть глубже (по желанию)

• Поиск вакансий идёт с выдачи под твоё резюме: https://hh.ru/search/vacancy?resume=<id> (см. scraper.py).
• Сбор вакансий часто через requests с куками из .session; клики по отклику — Playwright в профиле ~/.hh_browser_profile.
• Массовые отклики: сначала заполни своё письмо; заглушка REPLACE_ME в репозитории в отклик не подставляется.

---

Схема процесса (визуализация)

Общий поток: установка → авторизация → поиск / очередь → отклики → логи.

Дашборд — в Claude Code: /hh-dashboard или «запусти dashboard»; скрипт: python dashboard.py в корне клона https://github.com/fsbtactic-code/hhru. Локально схема: docs/flow.svg.

---

Лаборатория ИИ-маркетинга
Скиллы и разборы в Telegram