From 31fd316d51c273aadf0eb0d7418a257932ad56ba Mon Sep 17 00:00:00 2001 From: apuc Date: Wed, 16 Sep 2026 14:10:42 +0300 Subject: [PATCH] =?UTF-8?q?README:=20=D0=BF=D0=BE=D1=80=D1=82=2018091,=20?= =?UTF-8?q?=D1=80=D0=B5=D0=B3=D0=B8=D1=81=D1=82=D1=80=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D1=8F,=20=D0=BE=D0=B4=D0=BD=D0=BE-=D0=BA=D0=BB=D0=B8=D0=BA?= =?UTF-8?q?=D0=BE=D0=B2=D0=B0=D1=8F=20=D0=BE=D1=82=D0=BF=D1=80=D0=B0=D0=B2?= =?UTF-8?q?=D0=BA=D0=B0,=20=D0=BF=D0=B5=D1=80=D0=B5=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D0=BD=D1=8B=D0=B5=20=D0=BE=D0=BA=D1=80=D1=83=D0=B6=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 46 ++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 38 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 917e037..5320467 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ -# Автоотклик на hh.ru (полуавтоматический, безопасный) +# Автоотклик на hh.ru (полуавтоматический) Скрипт ищет вакансии на hh.ru по ключевым словам, генерирует персонализированный текст отклика через ИИ (на основе вашего резюме и описания вакансии), открывает -страницу в браузере и подставляет текст. **Кнопку «Отправить» всегда нажимаете вы** — -это не нарушает правила hh.ru и не рискует аккаунтом. +страницу в браузере, подставляет текст и резюме. Отправка — в один клик +(«Отправить отклик»), либо с проверкой текста перед отправкой. ## Установка @@ -25,17 +25,30 @@ PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright .venv/bin .venv/bin/python webui.py ``` -Откройте **http://localhost:5000** — там можно: +Откройте **http://localhost:18091** (порт меняется через `PORT`) — там можно: +- регистрироваться и входить (открытая регистрация, отключается `ALLOW_REGISTRATION=0`) - создавать аккаунты (имя, регион, поисковые запросы, стиль) - загружать резюме файлом (**txt, md, docx, pdf**) - сохранять **ключ сессии hh.ru** (cookies из браузера) — нужен для поиска и списка резюме - выбирать **резюме на hh.ru** — оно автоматически подставляется в модалке отклика - искать вакансии и видеть их списком (название, компания, зарплата, опыт) - генерировать тексты откликов через ИИ (редактируются перед отправкой) +- отправлять отклик в один клик: кнопка «Отправить отклик» в колонке действий — + браузер открывает вакансию, вставляет текст, жмёт «Отправить» и закрывается + (скриншот результата показывается в модалке) - открывать вакансию в браузере с уже вставленным текстом и выбранным резюме + для ручной проверки перед отправкой - отмечать отправленные — они больше не предлагаются +### Регистрация + +При первом запуске откройте `/register` и создайте логин с паролем (минимум +6 символов) — вы сразу войдёте. Каждый пользователь работает со своими +аккаунтами и лимитом генераций. Открытая регистрация отключается +`ALLOW_REGISTRATION=0` (пользователей тогда создаёт администратор через +`manage_users.py`). + ### Ключ сессии hh.ru Чтобы скрипт мог искать вакансии и видеть ваши резюме, нужны cookies из браузера: @@ -89,13 +102,30 @@ accounts/ 1. Скрипт парсит страницу поиска hh.ru по вашим запросам 2. Для каждой новой вакансии получает описание 3. ИИ генерирует текст отклика (вакансия + ваше резюме + стиль) -4. Браузер открывает вакансию, жмёт «Откликнуться», вставляет текст -5. **Вы проверяете текст и нажимаете «Отправить»** -6. Отмечаете отправленное — скрипт переходит к следующей +4. **Один клик**: кнопка «Отправить отклик» — браузер открывает вакансию, + жмёт «Откликнуться», вставляет текст, выбирает резюме, жмёт «Отправить» + и автоматически закрывается (скриншот результата — в модалке) +5. **С проверкой**: «Открыть в браузере» — вы проверяете текст и отправляете + сами, либо жмёте «Отправить отклик» в модалке скриншота +6. Отправленные вакансии отмечаются и больше не предлагаются + +## Переменные окружения (.env) + +| Переменная | По умолчанию | Описание | +|---|---|---| +| `LLM_API_KEY` | — | Ключ API для генерации текстов откликов | +| `SESSION_SECRET` | `dev-secret-change-me` | Секрет сессий Flask (обязательно сменить) | +| `PORT` | `18091` | Порт веб-интерфейса | +| `HOST` | `127.0.0.1` | Адрес прослушивания | +| `ALLOW_REGISTRATION` | `1` | Открытая регистрация (`0` — выключить) | +| `REGISTER_LLM_LIMIT` | `50` | Лимит генераций для новых пользователей | +| `HH_HEADLESS` | `0` | `1` — браузер без окна (для сервера без дисплея) | +| `PROXY_URL` | — | Прокси для браузера: `http://LOGIN:PASS@HOST:PORT` | ## Важно -- Скрипт не нарушает правила hh.ru: финальное действие всегда за человеком +- Отправка в один клик автоматически жмёт «Отправить» — используйте с осторожностью + и не чаще, чем позволяет hh.ru (паузы между страницами уже стоят) - Не запускайте поиск слишком часто — между страницами есть паузы - Если hh.ru покажет капчу — скрипт остановится, решите капчу вручную и запустите снова - `.env` содержит API-ключ — не коммитьте его в git (уже добавлен в `.gitignore`) \ No newline at end of file