# Add to your Claude Code skills
git clone https://github.com/fikstt2/hh-ai-agentLast scanned: 7/18/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-07-18T06:04:16.353Z",
"npmAuditRan": true,
"pipAuditRan": false,
"promptInjectionRan": true
}hh-ai-agent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by fikstt2. hh.ru аи бот для откликов. It has 214 GitHub stars.
Yes. hh-ai-agent passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/fikstt2/hh-ai-agent" and add it to your Claude Code skills directory (see the Installation section above).
hh-ai-agent is primarily written in Python. It is open-source under fikstt2 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh hh-ai-agent against similar tools.
No comments yet. Be the first to share your thoughts!
Агент автоматически ищет вакансии на HH.ru, оценивает их через LLM, генерирует сопроводительные письма и присылает подходящие в Telegram.
Запусти мастер настройки — он проведёт тебя через все шаги:
python setup_wizard.py
Wizard спросит:
После этого создаст .env и profile.yaml, проверит конфигурацию и покажет что делать дальше.
Изменить настройки позже:
python setup_wizard.py --edit
| Режим | Описание |
|---|---|
dry_run |
Ищет и анализирует вакансии, присылает превью в Telegram — без реальных откликов |
approval |
Присылает вакансию с кнопкой «Откликнуться» — отклик только после твоего нажатия |
Начинай с dry_run. Переходи на approval после того как убедишься что всё работает.
Карточка вакансии показывает краткое объяснение совпадения, рейтинг компании с HH и сворачиваемое сопроводительное письмо. Если rich messages недоступны, бот отправляет обычную HTML-карточку.
ollama pull llama3
Wizard создаёт отдельный MISTRAL_KEYS_MASTER_KEY для локального шифрования ключей. Сохрани резервную копию этого значения: без него уже сохранённые ключи расшифровать нельзя. После запуска ключами можно управлять командой /mistral_keys; в Telegram и логах показываются только последние четыре символа.
⚠️ При Mistral текст вакансий и твой профиль уходят во внешний API.
Поддерживается любой сервис с эндпоинтом /chat/completions (LocalAI, LM Studio, Groq и т.п.).
В wizard выбери OpenAI-compatible и укажи URL + ключ.
| Команда | Описание |
|---|---|
/start |
Краткая справка |
/status |
Режим, состояние, статистика |
/pause |
Приостановить поиск |
/resume |
Возобновить поиск |
/pending |
Вакансии, ожидающие решения |
/stats |
Статистика по статусам |
/diagnostics |
Результат последнего цикла и состояние circuit breaker |
/mistral_keys |
Список, проверка, добавление и удаление Mistral-ключей |
/cancel |
Отменить ввод CAPTCHA |
| Файл | Ответственность |
|---|---|
config.py |
Валидация .env и profile.yaml |
browser_backend.py |
CloakBrowser / Playwright адаптер |
hh_client.py |
Поиск, чтение страниц, отправка откликов |
llm/ |
Ollama / Mistral / OpenAI-compatible адаптеры, retry, квота |
ai_analyzer.py |
Анализ вакансий, генерация писем |
database.py |
SQLite-состояние, лимиты, переходы статусов |
approval.py |
Единственный разрешённый инициатор реального отклика |
tg_bot.py |
Telegram-команды, превью, inline-кнопки |
main.py |
Основной цикл агента |
setup_wizard.py |
Интерактивный мастер настройки |
APP_MODE=approval + ENABLE_REAL_APPLY=true + нажатие кнопки твоим Telegram ID; одноразовое разрешение действует 30 минут после нажатия.env, profile.yaml и .browser-profile/ исключены из Git.env не записываются в логи| Ошибка | Решение |
|---|---|
Configuration error |
Заполни все обязательные поля через python setup_wizard.py --edit |
CloakBrowser failed to start |
Проверь python -m cloakbrowser info, при необходимости смени на BROWSER_BACKEND=playwright |
HH.ru login is required |
Запусти с BROWSER_HEADLESS=false и войди вручную |
LLM check failed |
Проверь endpoint, ключ и дневную квоту через python main.py --check-llm |
Invalid model response |
Проверь провайдер и модель — вакансия безопасно пропускается |
Тесты не обращаются к HH.ru, Telegram или внешним LLM:
python -m compileall .
pytest -q
Огромное спасибо kkonstantin08 за разработку этой архитектуры — именно он спроектировал весь безопасный конвейер от поиска вакансий до approval-механизма с permit-токенами.
Также благодарность danscMax — он реализовал базовые проверки и валидацию конфигурации, которые легли в основу надёжной работы агента.
Вопросы и предложения: @fikstt3 (telegram)