hh-applicant-tool 1.4.7__py3-none-any.whl → 1.5.7__py3-none-any.whl

{hh_applicant_tool-1.4.7.dist-info → hh_applicant_tool-1.5.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hh-applicant-tool
-Version: 1.4.7
+Version: 1.5.7
 Summary: HH-Applicant-Tool: An automation utility for HeadHunter (hh.ru) designed to streamline the job search process by auto-applying to relevant vacancies and periodically refreshing resumes to stay at the top of recruiter searches.
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -11,7 +11,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: pillow
 Provides-Extra: playwright
+Requires-Dist: pillow (>=12.1.0,<13.0.0) ; extra == "pillow"
 Requires-Dist: playwright (>=1.57.0,<2.0.0) ; extra == "playwright"
 Requires-Dist: prettytable (>=3.6.0,<4.0.0)
 Requires-Dist: requests[socks] (>=2.32.3,<3.0.0)
@@ -19,7 +21,10 @@ Project-URL: Homepage, https://github.com/s3rgeym/hh-applicant-tool
 Project-URL: Repository, https://github.com/s3rgeym/hh-applicant-tool
 Description-Content-Type: text/markdown
 
-## HH Applicant Tool
+# HH Applicant Tool
+
+> [!NOTE]
+> Ищу почасовую или проектную [@feedback_s3rgeym_bot](https://t.me/feedback_s3rgeym_bot) (Python, Vue.js, Devops)
 
 ![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg)
 [![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)]()
@@ -32,51 +37,69 @@ Description-Content-Type: text/markdown
   <img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
 </div>
 
-### ✨ Ключевые преимущества
+### ☕ Поддержать проект
+
+[![Donate BTC](https://img.shields.io/badge/Donate-BTC-orange?style=for-the-badge&logo=bitcoin&logoColor=white)](bitcoin:BC1QWQXZX6D5Q0J5QVGH2VYXTFXX9Y6EPPGCW3REHS?label=%D0%94%D0%BB%D1%8F%20%D0%BF%D0%BE%D0%B6%D0%B5%D1%80%D1%82%D0%B2%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B9)
+
+**BTC Address:** `BC1QWQXZX6D5Q0J5QVGH2VYXTFXX9Y6EPPGCW3REHS`
+
+---
+
+## ✨ Ключевые преимущества
 
-- 💸 **Бесплатно.** В то время как сервисы в интернете или Telegram с аналогичным функционалом просят за свои услуги от 5.000 до 12.000 рублей в месяц.
+- 💸 **Полностью бесплатно.** В то время как сервисы в интернете или Telegram с аналогичным функционалом просят за свои услуги от 5.000 до 12.000 рублей в месяц.
 
-- 🔒 **Безопасность личных данных.** Ваши email, телефон, пароль и другие личные данные никуда не передаются в отличие от сторонних сервисов. В этом можно убедиться, изучив [открытый исходный код](https://github.com/s3rgeym/hh-applicant-tool/tree/main/hh_applicant_tool). Владельцы сторонних сервисов никогда вам не покажут исходники. Они знают о вас все и эти данные спокойно продадут каким-нибудь жуликам, либо те утекут в результате взлома.
+- 🔒 **Безопасность личных данных.** Ваши email, телефон, пароль и другие личные данные никуда не передаются в отличие от сторонних сервисов. В этом можно убедиться, изучив [открытый исходный код](https://github.com/s3rgeym/hh-applicant-tool/tree/main/src/hh_applicant_tool). Владельцы сторонних сервисов никогда вам не покажут исходники. Они знают о вас все и эти данные спокойно продадут каким-нибудь жуликам, либо те утекут в результате взлома.
+
+- 💾 **Сохранение контактов и прочей информации.** Контакты работодалей и информация о них и их вакансиях сохраняется в базе данных на вашем устройстве, что позволяет производить быстрый поиск нужной информации в отличии от сайта при минимальном опыте с SQL (язык запросов, придуманный в свое время для домохозяек).
 
 - 🛡️ **Гарантия от блокировок.** Утилита выполняет запросы с вашего устройства, имитируя обычного пользователя. Сервисы рассылают запросы для сотен аккаунтов с одного сервера, что повышает вероятность блокировки вашего аккаунта до 100%.
 
 - 😎 **Простота в использовании.** С утилитой разберется любой начинающий пользователь компьютера. Настолько, что херки в своем чате уже жалуются на массовые отклики от подростков 14-17 лет, которые успешно освоили данный инструмент.
 
-- 👯 **Мультиаккаунтность и управление резюме.** Вы можете использовать неограниченное количество профилей (аккаунтов), переключаясь между ними через разные файлы конфигурации. Утилита умеет работать со всеми вашими резюме: обновлять их даты публикации и подбирать вакансии под каждое из них.
+- 👯 **Мультиаккаунтность и управление резюме.** Утилита благодаря профилям может работать с неограниченным количеством аккаунтов и резюме.
+
+- 🖥️ **Полноценный CLI и работа на серверах.** Утилита имеет чистый консольный интерфейс. Несмотря на то, что для обхода защиты при авторизации используется браузер, он работает по умолчанию в фоновом (headless) режиме. Для `hh-applicant-tool` не нужна видеокарта или графическая оболочка (X-сервер), что позволяет авторизоваться даже с сервера или из докер-контейнера. Капча так же выводится прямо в терминал при использовании флагов `--kitty`/`--sixel`.
 
-- 🖥️ **Полноценный CLI и работа на серверах.** Утилита имеет чистый консольный интерфейс. Несмотря на то, что для обхода защиты при авторизации используется браузер, он работает по умолчанию в фоновом (headless) режиме. Для `hh-applicant-tool` не нужна видеокарта или графическая оболочка (X-сервер), что позволяет авторизоваться даже с сервера или из докер-контейнера.
+- 🚀 **Скриптинг.** Вы можете использовать утилиту из своих Python-скриптов.
 
-- 🚀 **Скриптинг.** Вы можете использовать утилиту из Python-скриптов!!! Благодаря этому вы можете ее интегрировать, например, в своего Telegram-бота.
+- 🤖 **Борьба с ATS и HR.** Россиянские говнокомпании внедрили ATS с нейронками, которые отклоняют отклик в течение 5 секунд. Отказ может прийти даже из-за отсутствия одного ключевого слова в резюме. Это не говоря уже о тупопездом фильтре, отсеивающем по знаку зодика (они не любят козерогов!!!). Это обесценивает ваши усилия на написание сопроводительных писем и чтение бесконечных портянок бреда, сгенерированных нейронками по запросу каких-то дур. Если тупые ичары решили себя не утруждать чтением резюме (они сейчас и сами перестали писать), то и вам незачем читать высеры этих филологинь и психологинь. Утилита избавляет вас от этой рутины, превращающей поиск работы в полноценную работу. Сейчас доля отказов составляет 98-99%, включая "молчунов" и прочих долбоебов, и единственный способ увеличить шансы просто попасть на собеседование — это автоматическая рассылка откликов на все подходящие вакансии. У большинства телефоны с двумя симками, а значит каждый может разослать до 400 откликов в сутки, а если нарегать акков на родню — еще больше!
 
-- 🤖 **Борьба с ATS и HR.** Компании уже массово внедрили ATS-системы с нейронными сетями, которые отклоняют ваш отклик в течение 30 секунд. Отказ может прийти из-за отсутствия одного ключевого слова в резюме, это уже не говоря о давно существующих фильтрах по полу, возрасту и даже региону происхождения (безопасники в банках отказывают даже русским, рожденным в Дагестане). Это обесценивает ваши усилия на написание сопроводительных писем и чтение бесконечных портянок бреда, сгенерированных нейронками по запросу каких-то дур. Если тупые кобылы решили себя не утруждать чтением резюме (они сейчас и сами перестали писать), то и вам незачем читать их высеры. Утилита избавляет вас от этой рутины, превращающей поиск работы в полноценную работу. Сейчас доля отказов составляет 98-99%, включая "молчунов", и единственный способ увеличить шансы просто попасть на собеседование — это автоматическая рассылка откликов на все подходящие вакансии.
+---
 
-### Содержание
+## Содержание
 
 - [HH Applicant Tool](#hh-applicant-tool)
+  - [☕ Поддержать проект](#-поддержать-проект)
   - [✨ Ключевые преимущества](#-ключевые-преимущества)
   - [Содержание](#содержание)
   - [Описание](#описание)
-  - [Внимание!!!](#внимание)
   - [Предыстория](#предыстория)
-  - [Установка](#установка)
+  - [Запуск через Docker](#запуск-через-docker)
+  - [Стандартная установка](#стандартная-установка)
     - [Установка утилиты](#установка-утилиты)
-    - [Установка зависимостей](#установка-зависимостей)
+    - [Дополнительные зависимости](#дополнительные-зависимости)
   - [Авторизация](#авторизация)
-  - [Конфигурация](#конфигурация)
   - [Описание команд](#описание-команд)
-  - [Формат текста сообщений](#формат-текста-сообщений)
   - [Использование AI](#использование-ai)
     - [OpenAI/ChatGPT](#openaichatgpt)
+  - [Шаблоны сообщений](#шаблоны-сообщений)
+  - [Данные приложения](#данные-приложения)
+    - [Конфигурационный файл](#конфигурационный-файл)
+    - [Логи](#логи)
+    - [База данных](#база-данных)
   - [Использование в скриптах](#использование-в-скриптах)
   - [Дополнительные настройки](#дополнительные-настройки)
-  - [Лицензия / License](#лицензия--license)
+  - [Лицензионное соглашение (Limited Non-Commercial License)](#лицензионное-соглашение-limited-non-commercial-license)
 
 ---
 
-### Описание
+## Описание
 
+> [!IMPORTANT]
 > Данной утилите похуй на "запрет" доступа к API HH сторонним приложениям, так как она прикидывается официальным приложением под Android
 
+> [!NOTE]
 > Утилита для генерации сопроводительного письма может использовать AI, в т. ч. ChatGPT. Подробное описание ниже
 
 Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU, таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита локально хранит информацию об откликах, в т. ч. полученные контакты. Это удобно, так как контакт сохранится, даже если вышлют отказ в дальнейшем. Мой совет: скрывайте свой номер от работодателя, если рассылаете отклики через утилиту, а то количество жуликов на красном сайте, мягко говоря, зашкаливает. У утилиты есть канал в дуровграме: [HH Applicant Tool](https://t.me/hh_applicant_tool). Старый <s>[HH Resume Automate](https://t.me/hh_resume_automate)</s> был выпилен какими-то долбоёбами, углядевшими во флаге Японии с двумя буквами «h» нарушение авторских прав...
@@ -91,19 +114,15 @@ asdf/pyenv/conda и что-то еще. В школотронской Manjaro и
 
 ![image](https://github.com/user-attachments/assets/a0cce1aa-884b-4d84-905a-3bb207eba4a3)
 
+> [!NOTE]
 > Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
 
+> [!NOTE]
 > Утилита автоматически подхватывает прокси из переменных окружения типа http_proxy или HTTPS_PROXY
 
-Данные об откликах, вакансиях и работодателях хранятся локально в БД. Для ее просмотра советую использовать **DB Browser**:
-
-<img width="1306" height="1000" alt="image" src="https://github.com/user-attachments/assets/67742b8d-a16c-4304-bd79-7ac99d53ed38" />
-
-### Внимание!!!
-
-Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/). Оно обладает минимальным функционалом: обновление резюме (одного) и рассылка откликов (чистить их и т. п. нельзя).
+---
 
-### Предыстория
+## Предыстория
 
 Долгое время я делал массовые заявки с помощью консоли браузера:
 
@@ -113,11 +132,191 @@ $$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
 
 Оно работает, хоть и не идеально. Я даже пробовал автоматизировать рассылки через `p[yu]ppeteer`, пока не прочитал [документацию](https://github.com/hhru/api). И не обнаружил, что **API** (интерфейс) содержит все необходимые мне методы. Headhunter позволяет создать свое приложение, но там ручная модерация, и навряд ли кто-то разрешит мне создать приложение для спама заявками. Я [декомпилировал](https://gist.github.com/s3rgeym/eee96bbf91b04f7eb46b7449f8884a00) официальное приложение для **Android** и получил **CLIENT_ID** и **CLIENT_SECRET**, необходимые для работы через **API**.
 
-### Установка
+---
+
+## Запуск через Docker
+
+Это рекомендованный способ разработчиком. Так же если не работает стандартная установка, то используйте его. Так же это самый простой способ запуска и использования утилиты, требующий скопипастить 5 команд. Он подойдет обладателям выделенных серверов, используемых под VPN. Единственным недостатком использования `docker` является требовательность его к месту, так как для запуска хромиума, который используется при авторизации, нужно половину убунты поставить (более гига).
+
+Для начала нужно установить `docker` и `docker-compose`:
+
+```sh
+sudo apt install docker.io docker-compose-v2
+```
+
+Выкачиваем репозиторий и переходим в каталог:
+
+```sh
+git clone https://github.com/s3rgeym/hh-applicant-tool
+cd hh-applicant-tool
+```
+
+> [!IMPORTANT]
+> Команды с docker-compose нужно запускать строго, находясь в данном каталоге!
+
+Теперь авторизуемся:
+
+```sh
+docker-compose run -u docker -it hh_applicant_tool \
+  hh-applicant-tool -vv auth -k
+```
+
+Пример вывода:
+
+```
+👤 Введите email или телефон: your-mail@gmail.com
+📨 Код был отправлен. Проверьте почту или SMS.
+📩 Введите полученный код: 1234
+🔓 Авторизация прошла успешно!
+```
+
+Авторизация с заданными логином и паролем выглядит так:
+
+```sh
+docker-compose run -u docker -it hh_applicant_tool \
+  hh-applicant-tool -vv auth -k '<login>' -p '<password>'
+```
+
+Капча отобразится только в терминале с поддержкой протокола **kitty**, например, в **Kitty**, **Ghostty** или **Konsole**.
+
+Если ваш терминал не поддерживает kitty protocol, то иожно попробовать использовать sixel protocol:
+
+```sh
+docker-compose run -u docker -it hh_applicant_tool \
+  hh-applicant-tool -vv auth -s
+```
+
+Подробно про авторизацию можно почитать [здесь](#авторизация).
+
+В случае успешной авторизации можно запускать рассылку откликов по крону:
+
+```sh
+docker-compose up -d
+```
+
+Что будет делать?
+
+- Рассылать отклики со всех опубликованных резюме.
+- Поднимать резюме.
+
+Просмотр логов `cron`:
+
+```sh
+docker compose logs -f
+```
+
+В выводе должно быть что-то типа:
+
+```sh
+hh_applicant_tool  | [Wed Jan 14 08:33:53 MSK 2026] Running startup tasks...
+hh_applicant_tool  | ℹ️ Токен не истек, обновление не требуется.
+hh_applicant_tool  | ✅ Обновлено Программист
+```
+
+Чтобы прекратить просмотр логов, нажмите `Ctrl-C`.
+
+Информацию об ошибках можно посмотреть в файле `config/log.txt`, а контакты работодателей — в `config/data` с помощью `sqlite3`. В `config/config.json` хранятся токены, дающие доступ к аккаунту.
 
-#### Установка утилиты
+Запущенные сервисы докер стартуют автоматически после перезагрузки. Остановить их можно выполнив:
 
-Универсальный с использованием pipx (требует пакета `python-pipx` в Arch):
+```sh
+docker-compose down
+```
+
+Чтобы обновить утилиту в большинству случаев достаточно в каталоге выполнить:
+
+```sh
+git pull
+```
+
+В редких случаях нужно пересобрать все:
+
+```sh
+docker compose up -d --build
+```
+
+Чтобы рассылать отклики с нескольких аккаунтов, нужно переписать `docker-compose.yml`:
+
+```yaml
+services:
+  # Не меняем ничего тут
+  hh_applicant_tool:
+    # ...
+
+  # Добавляем новые строки
+
+  # Просто копипастим, меняя имя сервиса, container_name и значение HH_PROFILE_ID
+  hh_second:
+    extends: hh_applicant_tool
+    container_name: hh_second
+    environment:
+      - HH_PROFILE_ID=second
+
+  hh_third:
+    extends: hh_applicant_tool
+    container_name: hh_third
+    environment:
+      - HH_PROFILE_ID=third
+
+  # Общий шаблон для новых профилей
+  уникальное_имя_сервиса:
+    extends: hh_applicant_tool
+    # может совпадать с именем сервиса
+    container_name: уникальное_имя_контейнера
+    environment:
+      - HH_PROFILE_ID=название_профиля
+```
+
+> [!IMPORTANT]
+> В этом файле важны отступы!
+
+Обратите внимание на `HH_PROFILE_ID` — его значение указывается при авторизации, если профиль отличен от дефолтного. Далее нужно авторизоваться в каждом профиле:
+
+```sh
+# Авторизуемся со второго профиля
+docker-compose exec -u docker -it hh_applicant_tool \
+  hh-applicant-tool --profile-id second auth -k
+
+# Авторизуемся с третьего профиля
+docker-compose exec -u docker -it hh_applicant_tool \
+  hh-applicant-tool --profile-id third auth -k
+
+# И так далее
+```
+
+Ну и выполнить `docker-compose up -d` чтобы запустить новые сервисы.
+
+[Команды](#описание-команд) можно потестировать в запущенном контейнере:
+
+```sh
+$ docker-compose exec -u docker -it hh_applicant_tool bash
+docker@1897bdd7c80b:/app$ hh-applicant-tool config -p
+/app/config/config.json
+docker@1897bdd7c80b:/app$ hh-applicant-tool refresh-token
+ℹ️ Токен не истек, обновление не требуется.
+docker@1897bdd7c80b:/app$
+```
+
+> [!IMPORTANT]
+> Обратите внимание, что `docker-compose exec`/`docker-compose run` запускаются с аргументами `-u docker`. Только для пользователя `docker` установлен `chromium`, необходимый для авторизации, а так же это избавляет от проблем с правами, когда созданные файлы для изменения требуют root-права.
+
+Если хотите команду `apply-similar` вызывать с какими-то аргументами, то создайте в корне файл `apply-similar.sh`:
+
+```sh
+#!/bin/bash
+
+/usr/local/bin/python -m hh_applicant_tool apply-similar -L messages.txt # укажите любые аргументы
+```
+
+В файлах `startup.sh` и `crontab` замените `/usr/local/bin/python -m hh_applicant_tool apply-similar` на `/bin/sh /app/apply-similar.sh`.
+
+---
+
+## Стандартная установка
+
+### Установка утилиты
+
+Универсальный способ с использованием pipx (требует пакета `python-pipx` в Arch):
 
 ```bash
 # Полная версия с поддержкой авторизации, включает Node.js и различные утилиты
@@ -128,6 +327,9 @@ $ pipx install 'hh-applicant-tool[playwright]'
 # Если хочется использовать самую последнюю версию, то можно установить ее через git
 $ pipx install "git+https://github.com/s3rgeym/hh-applicant-tool[playwright]"
 
+# Чтобы выводить капчу через sixel нужен pillow
+$ pipx install 'hh-applicant-tool[playwright,pillow]'
+
 # Для обновления до новой версии
 $ pipx upgrade hh-applicant-tool
 ```
@@ -148,14 +350,17 @@ pip install 'hh-applicant-tool[playwright]'
 
 - Для начала поставьте последнюю версию **Python 3** любым удобным способом.
 - Запустите **Terminal** или **PowerShell** от Администратора и выполните:
+
   ```ps
   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
   ```
+
   Данная политика разрешает текущему пользователю (от которого зашли) запускать скрипты. Без нее не будут работать виртуальные окружения.
 
 Далее можно поставить `pipx` и вернуться к инструкции в верху раздела:
 
 - Все так же от администратора выполните:
+
   ```ps
   python -m pip install --user pipx
   ```
@@ -182,32 +387,38 @@ pip install 'hh-applicant-tool[playwright]'
   ```
 
 - Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
+
   ```ps
   (hh-applicant-venv) PS> pip install 'hh-applicant-tool[playwright]'
   ```
+
 - Проверьте, работает ли оно:
+
   ```ps
   (hh-applicant-venv) PS> hh-applicant-tool -h
   ```
+
 - В случае неудачи вернитесь к первому шагу.
 - Для последующих запусков сначала активируйте виртуальное окружение.
 
-#### Установка зависимостей
+### Дополнительные зависимости
 
-После вышеописанного нужно установить зависимости в виде Chromium и других средств отладки:
+После вышеописанного нужно установить зависимости в виде Chromium и др:
 
 ```sh
-$ hh-applicant-tool install
+hh-applicant-tool install
 ```
 
 Этот шаг необязателен. Все это нужно только для авторизации.
 
-### Авторизация
+---
+
+## Авторизация
 
 Прямая авторизация:
 
 ```bash
-$ hh-applicant-tool authorize '<ваш телефон или email>' -p '<пароль>'
+hh-applicant-tool authorize '<ваш телефон или email>' -p '<пароль>'
 ```
 
 Если вы пропустили пункт про установку зависимостей, то увидите такую ошибку:
@@ -222,7 +433,6 @@ $ hh-applicant-tool authorize '<ваш телефон или email>' -p '<пар
 [E] name 'async_playwright' is not defined
 ```
 
-
 Если не помните пароль или др. причины, то можно авторизоваться с помощью одноразового кода:
 
 ```bash
@@ -232,18 +442,25 @@ $ hh-applicant-tool authorize '<ваш телефон или email>'
 🔓 Авторизация прошла успешно!
 ```
 
-- Если вы ввели телефон, то код придет через SMS
-- Если был введен Email, то проверьте почту
-
 Если же при вводе правильных данных возникает ошибка авторизации, то, скорее всего, требуется ввод капчи.
 
-Для ввода данных вручную:
+Капчу можно ввести через терминал, если тот поддерживает **kitty protocol** (например, **Kitty**, **Konsole**, **Ghostty** и др):
 
 ```sh
-hh-applicant-tool authorize --manual
+hh-applicant-tool authorize --use-kitty
 ```
 
-> Этот флаг не будет работать на сервере, так как требует наличия графического окружения
+<img width="843" height="602" alt="Untitled" src="https://github.com/user-attachments/assets/8f5dec0c-c3d4-4c5c-bd8b-3aeffa623d87" />
+
+Так же для вывода капчи можно использовать **sixel protocol**: `--use-sixel/--sixel/-s`. Это старый протокол, реализованный во множестве терминалов в **Linux**/**BSD** (**MacOS**). Он так же поддерживается в **Windows Terminal**, начиная с версии [1.22](https://devblogs.microsoft.com/commandline/windows-terminal-preview-1-22-release/#sixel-image-support).
+
+Из популярных современных терминалов вывод графики не поддерживает **Alacritty**.
+
+Ручная авторизация с запуском встроенного браузера:
+
+```sh
+hh-applicant-tool authorize --manual
+```
 
 Проверка авторизации:
 
@@ -254,57 +471,19 @@ $ hh-applicant-tool whoami
 
 В случае успешной авторизации токены будут сохранены в `config.json`.
 
+При удачной авторизации логин (почта или телефон) и пароль, если последний был передан, запоминаются и будут подставляться автоматически, если не указать их явно.
+
 Токен доступа выдается на две недели. Он обновляется автоматически. Для его ручного обновления нужно выполнить:
 
 ```bash
-$ hh-applicant-tool refresh-token
+hh-applicant-tool refresh-token
 ```
 
 Помните, что у `refresh_token` тоже есть время жизни, поэтому может потребоваться полная авторизация.
 
-### Конфигурация
-
-Конфигурации хранятся по следующим путям:
-
-| OS          | Путь                                                     |
-| ----------- | -------------------------------------------------------- |
-| **Windows** | `C:\Users\%username%\AppData\Roaming\hh-applicant-tool\` |
-| **macOS**   | `~/Library/Application Support/hh-applicant-tool/`       |
-| **Linux**   | `~/.config/hh-applicant-tool/`                           |
-
-Главный конфиг называется `config.json`. Он содержит токены. Полный путь до конфигурационного файла можно вывести с помощью команды:
-
-```bash
-hh-applicant-tool config -p
-```
-
-Через конфиг можно задать дополнительные настройки:
-
-| Имя атрибута    | Описание                                                                                   |
-| --------------- | ------------------------------------------------------------------------------------------ |
-| `proxy_url`     | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050`               |
-| `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений            |
-| `user_agent`    | Кастомный юзерагент, передаваемый при каждом запросе. По умолчанию используется от Android |
-| `client_id`     | Идентификатор клиента, используемый для авторизации. По умолчанию используется от Android  |
-| `client_secret` | Секретный ключ клиента, используемый для авторизации. По умолчанию используется от Android |
-
-В `log.txt` всегда можно посмотреть подробную информацию об ошибках. В целях безопасности токены, идентефикаторы резюме и тп затираются.
-
-Данные о работодателях и их вакансиях хранятся в файле `data`. Это обычная база `sqlite3`, вы ее можете просматривать через `DB Browser` и т. п.
-
-Что хранится в базе:
-
-* все просмотренные вакансии;
-* профили работодателей;
-* контакты работодателей;
-* данные об откликах;
-* иные данные, важные для работы.
-
-Если вы залогинитесь под другим аккаунтом, то данные не исчезнут.
-
-При использовании профиля, отличного от дефолтного, данные хранятся в подкаталоге.
+---
 
-### Описание команд
+## Описание команд
 
 Примеры команд:
 
@@ -356,7 +535,7 @@ $ hh-applicant-tool config -s proxy_url socks5h://localhost:1080
 $ hh-applicant-tool config -u proxy_url
 
 # Утилита все данные об откликах хранит в SQLite
-$ hh-applicant-tool query 'select count(*) from employer_contacts;'
+$ hh-applicant-tool query 'select count(*) from vacancy_contacts;'
 +----------+
 | count(*) |
 +----------+
@@ -364,38 +543,14 @@ $ hh-applicant-tool query 'select count(*) from employer_contacts;'
 +----------+
 
 # Экспорт контактов в csv
-$ hh-applicant-tool query 'select * from employer_contacts' --csv -o
+$ hh-applicant-tool query 'select * from vacancy_contacts' --csv -o
 contacts.csv
 
 # Выполнение запросов в интерактивном режиме
 $ hh-applicant-tool query
 
-# Вывести приглашения с удаленкой и зарплатой от 200.000 рублей
-$ hh-applicant-tool query <<<"SELECT
-    v.alternate_url,
-    v.name AS vacancy_name,
-    v.salary_from,
-    v.salary_to,
-    e.name AS employer_name,
-    e.site_url,
-    ec.name,
-    ec.email,
-    ec.phone_numbers
-FROM vacancies v
-JOIN negotiations n ON v.id = n.vacancy_id
-JOIN employers e ON n.employer_id = e.id
-LEFT JOIN employer_contacts ec ON e.id = ec.employer_id
-WHERE v.salary_from >= 200000
-  AND v.currency = 'RUR'
-  AND v.remote = 1
-  AND n.state IN ('invitation', 'interview', 'hired')
-ORDER BY v.salary_from DESC, v.salary_to DESC;"
-
-# Перед выполнением запросов к базе желательно синхронизировать отклики
-$ hh-applicant-tool sync-negotiations
-
 # Чистим отказы
-$ hh-applicant-tool sync --clean
+$ hh-applicant-tool clear-negotiations
 
 # При обновлении может сломаться схема БД, для ее починки нужно выполнить
 # поочерёдно все миграции, добавленные после выхода последней версии
@@ -413,7 +568,6 @@ $ hh-applicant-tool settings
 | Тип      | Ключ                    | Значение                |
 +----------+-------------------------+-------------------------+
 | str      | user.email              | dmitry.kozlov@yandex.ru |
-| int      | auth.last_login         | 1768462521              |
 +----------+-------------------------+-------------------------+
 
 # Получить значение по ключу
@@ -435,9 +589,9 @@ $ hh-applicant-tool settings auth.username 'user@example.com'
 | **whoami**, **id**                 | Выводит информацию об авторизованном пользователе                                                                                                                                                                          |
 | **list-resumes**, **list**, **ls** | Список резюме                                                                                                                                                                                                              |
 | **update-resumes**, **update**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                                                                                                                                            |
-| **apply-similar**                  | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан.                                               |
+| **apply-similar**                  | Откликнуться на все подходящие вакансии СО ВСЕХ РЕЗЮМЕ. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан.                                |
 | **reply-employers**, **reply**     | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ                                                                                                                               |
-| **check-negotiations**             | Синхронизация откликов с возможностью их отмены                                                                                                                                                                            |
+| **clear-negotiations**             | Отмена откликов                                                                                                                                                                                                            |
 | **call-api**, **api**              | Вызов произвольного метода API с выводом результата.                                                                                                                                                                       |
 | **refresh-token**, **refresh**     | Обновляет access_token.                                                                                                                                                                                                    |
 | **config**                         | Показывает содержимое конфига. С флагом -e открывает его для редактирования.                                                                                                                                               |
@@ -446,10 +600,10 @@ $ hh-applicant-tool settings auth.username 'user@example.com'
 | **uninstall**                      | Удаляет браузер Chromium, используемый для авторизации.                                                                                                                                                                    |
 | **check-proxy**                    | Проверяет используемые прокси                                                                                                                                                                                              |
 | **migrate**                        | Починить базу                                                                                                                                                                                                              |
-| **query**                          | Выполнение SQL-запросов к базе. Схема БД находится в файле   [schema.sql](./hh_hh_applicant_tool/storage/queries/schema.sql). Если скормить ее [DeepSeek](https://chat.deepseek.com), то он поможет написать любой запрос. |
-| **log**                            | Просмотр файла-лога. С флагом -f будет следить за изменениями.                                                                                                                                                             |
+| **query**                          | Выполнение SQL-запросов к базе. Схема БД находится в файле   [schema.sql](./src//hh_hh_applicant_tool/storage/queries/schema.sql). Если скормить ее [DeepSeek](https://chat.deepseek.com), то он поможет написать любой запрос. |
+| **log**                            | Просмотр файла-лога. С флагом -f будет следить за изменениями. В логах частично скрыты идентефикаторы в целях безопасности.                                                                                                |
 
-Утилита использует систему плагинов. Все они лежат в [operations](https://github.com/s3rgeym/hh-applicant-tool/tree/main/hh_applicant_tool/operations). Модули, расположенные там, автоматически добавляются как доступные команды. За основу для своего плагина можно взять [whoami.py](https://github.com/s3rgeym/hh-applicant-tool/tree/main/hh_applicant_tool/operations/whoami.py).
+Утилита использует систему плагинов. Все они лежат в [operations](https://github.com/s3rgeym/hh-applicant-tool/tree/main/src/hh_applicant_tool/operations). Модули, расположенные там, автоматически добавляются как доступные команды. За основу для своего плагина можно взять [whoami.py](https://github.com/s3rgeym/hh-applicant-tool/tree/main/src/hh_applicant_tool/operations/whoami.py).
 
 Для тестирования запросов к API используйте команду `call-api` совместно с `jq` для обработки JSON.
 
@@ -465,7 +619,7 @@ https://hh.ru/employer/4679771
 Синтаксис `call-api` немного похож на `httpie` или `curlie`:
 
 ```sh
-$ hh-applicant-tool call-api -m {GET|POST|PUT|DELETE} /path/to/endpoint key1=value1 ... keyN=valueN
+hh-applicant-tool call-api [-m {GET|POST|PUT|DELETE}] <endpoint> [<key=value> ...]
 ```
 
 Если используется метод `GET` или `DELETE` (или ничего не указано), то параметры будут переданы как query string. Во всех остальных случаях парметры передаются как `application/x-www-form-urlencoded` в теле запроса.
@@ -484,15 +638,57 @@ npx @redocly/cli preview -d docs/hhapi
 
 Потом нужно открыть в браузере [http://localhost:4000](http://localhost:4000).
 
+> [!NOTE]
 > Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвращаться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать, есть ли тело у ответа сервера, нужно его пробовать прочитать. Я так понял, там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бэкенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то вроде этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)`, чтобы отсеить какие-то вакансии.
 
+По сути, никакие дополнительные команды, кроме имеющихся, не нужны. Вы можете сделать что угодно с помощью `call-api`, но если хочется чего-то особенного, можно добавить свои команды.
+
+---
 
+## Использование AI
 
-По сути, никакие дополнительные команды, кроме имеющихся, не нужны. Вы можете сделать что угодно с помощью `call-api`, но если хочется чего-то особенного, можно добавить свои команды.
+Для генерации опроводительных писем при откликах и ответа в чаты работодателей (`reply-employers`) можно использовать OpenAI (ChatGPT).
+
+Пример рассылки откликов с генерированным письмом:
+
+```sh
+hh-applicant-tool apply-similar -f --ai
+```
+
+Генерацию сопроводительных писем в откликах я считаю лишним, так как их никто не читает. Экономнее воспользоваться шаблонами сообщений.
+
+---
+
+### OpenAI/ChatGPT
+
+Отредактируйте конфиг:
+
+```sh
+hh-applicant-tool config -e
+```
+
+Добавьте в него эти строки:
+
+```json
+{
+  "openai": {
+    "token": "ВАШ_API_КЛЮЧ_OPENAI",
+    "model": "ВАША_МОДЕЛЬ",
+    // Это дефолтные значения, которые можно переопределить
+    "temperature": 0.7,
+    "max_completion_tokens": 1000,
+    // Вместо ChatGPT можно использовать другие сервисы
+    // Учтите, что при исп-ии Docker нужно указывать 192.168... вместо localhost
+    "completion_endpoint": "http://localhost:3000...",
+  }
+}
+```
+
+---
 
-### Формат текста сообщений
+## Шаблоны сообщений
 
-Команда `apply-similar` поддерживает специальный формат сообщений.
+Команды `apply-similar` и `reply-employers` поддерживают специальный формат сообщений.
 
 Так же в сообщении можно использовать плейсхолдеры:
 
@@ -502,6 +698,7 @@ npx @redocly/cli preview -d docs/hhapi
 - **`%(last_name)s`**: Фамилия пользователя.
 - **`%(email)s`**: Email пользователя.
 - **`%(phone)s`**: Телефон пользователя.
+- **`%(resume_title)s`**: Название резюме.
 
 Эти плейсхолдеры могут быть использованы в сообщениях для отклика на вакансии, чтобы динамически подставлять соответствующие данные в текст сообщения. Например:
 
@@ -521,36 +718,60 @@ npx @redocly/cli preview -d docs/hhapi
 Привет, как ты?
 ```
 
-### Использование AI
+---
 
-Для генерации опроводительных писем при откликах и ответа в чаты работодателей (`reply-employers`) можно использовать OpenAI (ChatGPT).
+## Данные приложения
 
-Пример рассылки откликов с генерированным письмом:
+Данные приложения хранятся по следующим путям:
 
-```sh
-hh-applicant-tool apply-similar -f --ai
-```
+| OS          | Путь                                                     |
+| ----------- | -------------------------------------------------------- |
+| **Windows** | `C:\Users\%username%\AppData\Roaming\hh-applicant-tool\` |
+| **macOS**   | `~/Library/Application Support/hh-applicant-tool/`       |
+| **Linux**   | `~/.config/hh-applicant-tool/`                           |
 
-#### OpenAI/ChatGPT
+### Конфигурационный файл
 
-Отредактируйте конфиг:
+Главный конфиг называется `config.json`. Он содержит токены. Полный путь до конфигурационного файла можно вывести с помощью команды:
 
-```sh
-hh-applicant-tool config -e
+```bash
+hh-applicant-tool config -p
 ```
 
-Добавьте в него эти строки:
+Через конфиг можно задать дополнительные настройки:
 
-```json
-{
-  "openai": {
-    "token": "ВАШ_API_КЛЮЧ_OPENAI",
-    "model": "ВАША_МОДЕЛЬ",
-  }
-}
-```
+| Имя атрибута    | Описание                                                                                   |
+| --------------- | ------------------------------------------------------------------------------------------ |
+| `proxy_url`     | Прокси, используемый для всех запросов, например, `socks5h://localhost:1080`               |
+| `api_delay`     | Минимальная между отправкой запросов к API HH                                              |
+| `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений            |
+| `user_agent`    | Кастомный юзерагент, передаваемый при каждом запросе. По умолчанию используется от Android |
+| `client_id`     | Идентификатор клиента, используемый для авторизации. По умолчанию используется от Android  |
+| `client_secret` | Секретный ключ клиента, используемый для авторизации. По умолчанию используется от Android |
+
+Если вы залогинитесь под другим аккаунтом, то данные не исчезнут.
+
+При использовании профиля, отличного от дефолтного, данные хранятся в подкаталоге.
+
+### Логи
+
+В `log.txt` всегда можно посмотреть подробную информацию об ошибках. В целях безопасности токены, идентефикаторы резюме и тп затираются.
+
+### База данных
+
+Данные о работодателях и их вакансиях хранятся в файле `data`. Это обычная база `sqlite3`, вы ее можете просматривать через `DB Browser` и т. п.
+
+Что хранится в базе:
+
+- все просмотренные вакансии;
+- профили работодателей;
+- контакты работодателей;
+- данные об откликах;
+- иные данные, важные для работы.
 
-### Использование в скриптах
+---
+
+## Использование в скриптах
 
 Если хотите использовать `hh-applicant-tool` в своих скриптах, то можно это сделать так:
 
@@ -584,45 +805,46 @@ tool.save_token()
 📩 Введите полученный код:
 ```
 
-### Дополнительные настройки
+---
+
+## Дополнительные настройки
 
-Если вы обычный пользователь, то ничего лучше не трогайте.
+<details>
+<summary>Если вы обычный пользователь, то ничего лучше не трогайте.</summary>
 
 Отключение проверки версии с выводом предупреждения:
 
 ```sh
-$ hh-applicant-tool settings disable_version_check true
+hh-applicant-tool settings disable_version_check true
 ```
 
 Утилита ищет в логах информацию о Python-ошибках. Они отправляются на сервер разработчика с целью их оперативного исправления, однако, вы можете отключить отправку отчетов:
 
 ```sh
-$ hh-applicant-tool settings send_error_reports false
+hh-applicant-tool settings send_error_reports false
 ```
-</details>
-
-### Лицензия / License
 
-**© 2023-2026 Sergey M. Все права защищены.**
+</details>
 
-Данное программное обеспечение предоставляется на условиях **ограниченной некоммерческой лицензии**.
+---
 
-- Разрешенное использование
-  * Разрешается бесплатное использование, копирование и модификация кода исключительно в **личных**, **образовательных** и **ознакомительных** целях.
-  * Разрешено использование в свободном некоммерческом ПО с открытым исходным кодом СТРОГО С УКАЗАНИЕМ ССЫЛОК НА ДАННЫЙ РЕПОЗИТОРИЙ И АВТОРА.
+## Лицензионное соглашение (Limited Non-Commercial License)
 
-- Ограничения в использовании
-  Категорически запрещается использование данного кода (а также его частей или производных) в любых коммерческих целях без предварительного псогласия автора. Это включает, но не ограничивается:
-    * Интеграцию кода в платные сервисы, приложения или веб-сайты.
-    * Использование кода для оказания платных услуг (SaaS, консалтинг, техподдержка).
-    * Перепродажу или сублицензирование кода.
+Данное программное обеспечение распространяется на условиях **ограниченной некоммерческой лицензии**.
 
-- Отказ от ответственности
-  Программа предоставляется на условиях «как есть» (AS IS). Автор не несет ответственности за любые прямые или косвенные убытки, возникшие в результате использования данного ПО.
+- **Разрешённое использование**
+  - **Личное использование и изучение:** Разрешается копирование и модификация кода исключительно для личного ознакомления, обучения и отладки **без права публикации или распространения изменений**.
+  - **Интеграция в программное обеспечение:** Разрешается включение данного кода в состав сторонних бесплатных некоммерческих продуктов **только при полном сохранении исходного кода в неизменном виде**.
+  - **Атрибуция:** Любое распространение, демонстрация или использование кода (в том числе в составе других продуктов) допускается **только при обязательном указании автора и ссылки на оригинальный репозиторий**.
 
----
+- **Ограничения на использование**
+  **Строго запрещается** использование данного кода в любых коммерческих целях без предварительного письменного согласия автора, включая, но не ограничиваясь:
+  - Интеграцией в платные сервисы, приложения, веб-сайты либо использованием в рамках оказания платных услуг.
+  - Публикацией, распространением или передачей третьим лицам **модифицированных (изменённых) версий** кода.
+  - Перепродажей, сублицензированием либо использованием кода в интересах коммерческих организаций.
 
-**Copyright (c) 2023-2026 Sergey M. All rights reserved.**
+- **Отказ от ответственности**
+  Программное обеспечение предоставляется по принципу «как есть» (**AS IS**). Автор не несёт ответственности за любые прямые или косвенные убытки, включая, но не ограничиваясь, блокировкой аккаунтов, потерей данных или иными негативными последствиями, возникшими в результате использования данного программного обеспечения.
 
-This software is provided for **FREE PERSONAL USE ONLY**. Any commercial use, including integration into paid services or commercial consulting, is **STRICTLY PROHIBITED**.
+**© 2023-2026 Sergey M. Все права защищены.**