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

{hh_applicant_tool-1.4.12.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.12
+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
@@ -21,8 +21,9 @@ 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)
@@ -36,39 +37,49 @@ 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 рублей в месяц.
 
 - 🔒 **Безопасность личных данных.** Ваши email, телефон, пароль и другие личные данные никуда не передаются в отличие от сторонних сервисов. В этом можно убедиться, изучив [открытый исходный код](https://github.com/s3rgeym/hh-applicant-tool/tree/main/src/hh_applicant_tool). Владельцы сторонних сервисов никогда вам не покажут исходники. Они знают о вас все и эти данные спокойно продадут каким-нибудь жуликам, либо те утекут в результате взлома.
 
-- 💾 **Сохранение контактов и прочей информации.** Контакты работодалей и информация о них и их вакансиях сохраняется в базе данных, что позволяет производить быстрый поиск нужной информации в отличии от сайта.
+- 💾 **Сохранение контактов и прочей информации.** Контакты работодалей и информация о них и их вакансиях сохраняется в базе данных на вашем устройстве, что позволяет производить быстрый поиск нужной информации в отличии от сайта при минимальном опыте с SQL (язык запросов, придуманный в свое время для домохозяек).
 
 - 🛡️ **Гарантия от блокировок.** Утилита выполняет запросы с вашего устройства, имитируя обычного пользователя. Сервисы рассылают запросы для сотен аккаунтов с одного сервера, что повышает вероятность блокировки вашего аккаунта до 100%.
 
 - 😎 **Простота в использовании.** С утилитой разберется любой начинающий пользователь компьютера. Настолько, что херки в своем чате уже жалуются на массовые отклики от подростков 14-17 лет, которые успешно освоили данный инструмент.
 
-- 👯 **Мультиаккаунтность и управление резюме.** Вы можете использовать неограниченное количество профилей (аккаунтов), переключаясь между ними через разные файлы конфигурации. Утилита умеет работать со всеми вашими резюме: обновлять их даты публикации и подбирать вакансии под каждое из них.
+- 👯 **Мультиаккаунтность и управление резюме.** Утилита благодаря профилям может работать с неограниченным количеством аккаунтов и резюме.
 
-- 🖥️ **Полноценный CLI и работа на серверах.** Утилита имеет чистый консольный интерфейс. Несмотря на то, что для обхода защиты при авторизации используется браузер, он работает по умолчанию в фоновом (headless) режиме. Для `hh-applicant-tool` не нужна видеокарта или графическая оболочка (X-сервер), что позволяет авторизоваться даже с сервера или из докер-контейнера.
+- 🖥️ **Полноценный CLI и работа на серверах.** Утилита имеет чистый консольный интерфейс. Несмотря на то, что для обхода защиты при авторизации используется браузер, он работает по умолчанию в фоновом (headless) режиме. Для `hh-applicant-tool` не нужна видеокарта или графическая оболочка (X-сервер), что позволяет авторизоваться даже с сервера или из докер-контейнера. Капча так же выводится прямо в терминал при использовании флагов `--kitty`/`--sixel`.
 
 - 🚀 **Скриптинг.** Вы можете использовать утилиту из своих Python-скриптов.
 
-- 🤖 **Борьба с ATS и HR.** Компании уже массово внедрили ATS-системы с нейронными сетями, которые отклоняют ваш отклик в течение 30 секунд. Отказ может прийти из-за отсутствия одного ключевого слова в резюме, это уже не говоря о давно существующих фильтрах по полу, возрасту и даже региону происхождения (безопасники в банках отказывают даже русским, рожденным в Дагестане). Это обесценивает ваши усилия на написание сопроводительных писем и чтение бесконечных портянок бреда, сгенерированных нейронками по запросу каких-то дур. Если тупые кобылы решили себя не утруждать чтением резюме (они сейчас и сами перестали писать), то и вам незачем читать их высеры. Утилита избавляет вас от этой рутины, превращающей поиск работы в полноценную работу. Сейчас доля отказов составляет 98-99%, включая "молчунов", и единственный способ увеличить шансы просто попасть на собеседование — это автоматическая рассылка откликов на все подходящие вакансии.
+- 🤖 **Борьба с ATS и HR.** Россиянские говнокомпании внедрили ATS с нейронками, которые отклоняют отклик в течение 5 секунд. Отказ может прийти даже из-за отсутствия одного ключевого слова в резюме. Это не говоря уже о тупопездом фильтре, отсеивающем по знаку зодика (они не любят козерогов!!!). Это обесценивает ваши усилия на написание сопроводительных писем и чтение бесконечных портянок бреда, сгенерированных нейронками по запросу каких-то дур. Если тупые ичары решили себя не утруждать чтением резюме (они сейчас и сами перестали писать), то и вам незачем читать высеры этих филологинь и психологинь. Утилита избавляет вас от этой рутины, превращающей поиск работы в полноценную работу. Сейчас доля отказов составляет 98-99%, включая "молчунов" и прочих долбоебов, и единственный способ увеличить шансы просто попасть на собеседование — это автоматическая рассылка откликов на все подходящие вакансии. У большинства телефоны с двумя симками, а значит каждый может разослать до 400 откликов в сутки, а если нарегать акков на родню — еще больше!
+
+---
 
-### Содержание
+## Содержание
 
 - [HH Applicant Tool](#hh-applicant-tool)
+  - [☕ Поддержать проект](#-поддержать-проект)
   - [✨ Ключевые преимущества](#-ключевые-преимущества)
   - [Содержание](#содержание)
   - [Описание](#описание)
   - [Предыстория](#предыстория)
-  - [Установка](#установка)
-    - [Через Docker](#через-docker)
-    - [Обычная установка](#обычная-установка)
-      - [Установка самой утилиты](#установка-самой-утилиты)
-      - [Установка дополнительных зависимостей](#установка-дополнительных-зависимостей)
-  - [Об авторизации](#об-авторизации)
+  - [Запуск через Docker](#запуск-через-docker)
+  - [Стандартная установка](#стандартная-установка)
+    - [Установка утилиты](#установка-утилиты)
+    - [Дополнительные зависимости](#дополнительные-зависимости)
+  - [Авторизация](#авторизация)
   - [Описание команд](#описание-команд)
   - [Использование AI](#использование-ai)
     - [OpenAI/ChatGPT](#openaichatgpt)
@@ -79,15 +90,16 @@ Description-Content-Type: text/markdown
     - [База данных](#база-данных)
   - [Использование в скриптах](#использование-в-скриптах)
   - [Дополнительные настройки](#дополнительные-настройки)
-  - [TODO](#todo)
   - [Лицензионное соглашение (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» нарушение авторских прав...
@@ -102,11 +114,15 @@ asdf/pyenv/conda и что-то еще. В школотронской Manjaro и
 
 ![image](https://github.com/user-attachments/assets/a0cce1aa-884b-4d84-905a-3bb207eba4a3)
 
+> [!NOTE]
 > Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
 
+> [!NOTE]
 > Утилита автоматически подхватывает прокси из переменных окружения типа http_proxy или HTTPS_PROXY
 
-### Предыстория
+---
+
+## Предыстория
 
 Долгое время я делал массовые заявки с помощью консоли браузера:
 
@@ -116,11 +132,11 @@ $$('[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
+## Запуск через Docker
 
-Это самый простой способ для тех, кому лень разбираться с работой утилиты.
+Это рекомендованный способ разработчиком. Так же если не работает стандартная установка, то используйте его. Так же это самый простой способ запуска и использования утилиты, требующий скопипастить 5 команд. Он подойдет обладателям выделенных серверов, используемых под VPN. Единственным недостатком использования `docker` является требовательность его к месту, так как для запуска хромиума, который используется при авторизации, нужно половину убунты поставить (более гига).
 
 Для начала нужно установить `docker` и `docker-compose`:
 
@@ -128,40 +144,49 @@ $$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
 sudo apt install docker.io docker-compose-v2
 ```
 
-Выкачиваем репозиторий:
+Выкачиваем репозиторий и переходим в каталог:
 
 ```sh
 git clone https://github.com/s3rgeym/hh-applicant-tool
+cd hh-applicant-tool
 ```
 
-Переходим в каталог с `docker-compose.yml`:
-
-```sh
-cd hh-applicant-tool/docker
-```
+> [!IMPORTANT]
+> Команды с docker-compose нужно запускать строго, находясь в данном каталоге!
 
-Теперь авторизуйтесь:
+Теперь авторизуемся:
 
 ```sh
-docker-compose run --rm -it -e TERM=$TERM hh-applicant-tool \
-  hh-applicant-tool -vv -c /app/config auth -k
+docker-compose run -u docker -it hh_applicant_tool \
+  hh-applicant-tool -vv auth -k
 ```
 
 Пример вывода:
 
 ```
-WARN[0000] No services to build
-WARN[0000] No services to build
-Container docker-tool-run-dfbc9f44c6a9 Creating
-Container docker-tool-run-dfbc9f44c6a9 Created
 👤 Введите email или телефон: your-mail@gmail.com
 📨 Код был отправлен. Проверьте почту или SMS.
 📩 Введите полученный код: 1234
 🔓 Авторизация прошла успешно!
 ```
 
+Авторизация с заданными логином и паролем выглядит так:
 
-Капча отобразится только в терминале с поддержкой протокола **kitty**, например, в **Konsole**.
+```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
+```
+
+Подробно про авторизацию можно почитать [здесь](#авторизация).
 
 В случае успешной авторизации можно запускать рассылку откликов по крону:
 
@@ -174,19 +199,124 @@ docker-compose up -d
 - Рассылать отклики со всех опубликованных резюме.
 - Поднимать резюме.
 
-Информацию об ошибках можно посмотреть в файле `config/log.txt`, а контакты работодателей посмотреть в `config/data` с помощью `sqlite3`.
+Просмотр логов `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` хранятся токены, дающие доступ к аккаунту.
+
+Запущенные сервисы докер стартуют автоматически после перезагрузки. Остановить их можно выполнив:
 
 ```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
+
+# И так далее
+```
 
-Универсальный с использованием pipx (требует пакета `python-pipx` в Arch):
+Ну и выполнить `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 и различные утилиты
@@ -197,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
 ```
@@ -217,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
   ```
@@ -251,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 '<пароль>'
 ```
 
 Если вы пропустили пункт про установку зависимостей, то увидите такую ошибку:
@@ -291,7 +433,6 @@ $ hh-applicant-tool authorize '<ваш телефон или email>' -p '<пар
 [E] name 'async_playwright' is not defined
 ```
 
-
 Если не помните пароль или др. причины, то можно авторизоваться с помощью одноразового кода:
 
 ```bash
@@ -303,7 +444,7 @@ $ hh-applicant-tool authorize '<ваш телефон или email>'
 
 Если же при вводе правильных данных возникает ошибка авторизации, то, скорее всего, требуется ввод капчи.
 
-Капчу можно ввести через терминал, если тот поддерживает kitty protocol (например, Kitty, Konsole, Ghostty и др):
+Капчу можно ввести через терминал, если тот поддерживает **kitty protocol** (например, **Kitty**, **Konsole**, **Ghostty** и др):
 
 ```sh
 hh-applicant-tool authorize --use-kitty
@@ -311,6 +452,10 @@ 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
@@ -326,15 +471,19 @@ $ hh-applicant-tool whoami
 
 В случае успешной авторизации токены будут сохранены в `config.json`.
 
+При удачной авторизации логин (почта или телефон) и пароль, если последний был передан, запоминаются и будут подставляться автоматически, если не указать их явно.
+
 Токен доступа выдается на две недели. Он обновляется автоматически. Для его ручного обновления нужно выполнить:
 
 ```bash
-$ hh-applicant-tool refresh-token
+hh-applicant-tool refresh-token
 ```
 
 Помните, что у `refresh_token` тоже есть время жизни, поэтому может потребоваться полная авторизация.
 
-### Описание команд
+---
+
+## Описание команд
 
 Примеры команд:
 
@@ -419,7 +568,6 @@ $ hh-applicant-tool settings
 | Тип      | Ключ                    | Значение                |
 +----------+-------------------------+-------------------------+
 | str      | user.email              | dmitry.kozlov@yandex.ru |
-| int      | auth.last_login         | 1768462521              |
 +----------+-------------------------+-------------------------+
 
 # Получить значение по ключу
@@ -452,7 +600,7 @@ $ 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), то он поможет написать любой запрос. |
+| **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/src/hh_applicant_tool/operations). Модули, расположенные там, автоматически добавляются как доступные команды. За основу для своего плагина можно взять [whoami.py](https://github.com/s3rgeym/hh-applicant-tool/tree/main/src/hh_applicant_tool/operations/whoami.py).
@@ -471,7 +619,7 @@ https://hh.ru/employer/4679771
 Синтаксис `call-api` немного похож на `httpie` или `curlie`:
 
 ```sh
-$ hh-applicant-tool call-api [-m {GET|POST|PUT|DELETE}] <endpoint> [<key=value> ...]
+hh-applicant-tool call-api [-m {GET|POST|PUT|DELETE}] <endpoint> [<key=value> ...]
 ```
 
 Если используется метод `GET` или `DELETE` (или ничего не указано), то параметры будут переданы как query string. Во всех остальных случаях парметры передаются как `application/x-www-form-urlencoded` в теле запроса.
@@ -490,13 +638,14 @@ 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
+---
+
+## Использование AI
 
 Для генерации опроводительных писем при откликах и ответа в чаты работодателей (`reply-employers`) можно использовать OpenAI (ChatGPT).
 
@@ -508,7 +657,9 @@ hh-applicant-tool apply-similar -f --ai
 
 Генерацию сопроводительных писем в откликах я считаю лишним, так как их никто не читает. Экономнее воспользоваться шаблонами сообщений.
 
-#### OpenAI/ChatGPT
+---
+
+### OpenAI/ChatGPT
 
 Отредактируйте конфиг:
 
@@ -523,11 +674,19 @@ hh-applicant-tool config -e
   "openai": {
     "token": "ВАШ_API_КЛЮЧ_OPENAI",
     "model": "ВАША_МОДЕЛЬ",
+    // Это дефолтные значения, которые можно переопределить
+    "temperature": 0.7,
+    "max_completion_tokens": 1000,
+    // Вместо ChatGPT можно использовать другие сервисы
+    // Учтите, что при исп-ии Docker нужно указывать 192.168... вместо localhost
+    "completion_endpoint": "http://localhost:3000...",
   }
 }
 ```
 
-### Шаблоны сообщений
+---
+
+## Шаблоны сообщений
 
 Команды `apply-similar` и `reply-employers` поддерживают специальный формат сообщений.
 
@@ -559,7 +718,9 @@ hh-applicant-tool config -e
 Привет, как ты?
 ```
 
-### Данные приложения
+---
+
+## Данные приложения
 
 Данные приложения хранятся по следующим путям:
 
@@ -569,7 +730,7 @@ hh-applicant-tool config -e
 | **macOS**   | `~/Library/Application Support/hh-applicant-tool/`       |
 | **Linux**   | `~/.config/hh-applicant-tool/`                           |
 
-#### Конфигурационный файл
+### Конфигурационный файл
 
 Главный конфиг называется `config.json`. Он содержит токены. Полный путь до конфигурационного файла можно вывести с помощью команды:
 
@@ -581,7 +742,8 @@ hh-applicant-tool config -p
 
 | Имя атрибута    | Описание                                                                                   |
 | --------------- | ------------------------------------------------------------------------------------------ |
-| `proxy_url`     | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050`               |
+| `proxy_url`     | Прокси, используемый для всех запросов, например, `socks5h://localhost:1080`               |
+| `api_delay`     | Минимальная между отправкой запросов к API HH                                              |
 | `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений            |
 | `user_agent`    | Кастомный юзерагент, передаваемый при каждом запросе. По умолчанию используется от Android |
 | `client_id`     | Идентификатор клиента, используемый для авторизации. По умолчанию используется от Android  |
@@ -591,23 +753,25 @@ hh-applicant-tool config -p
 
 При использовании профиля, отличного от дефолтного, данные хранятся в подкаталоге.
 
-#### Логи
+### Логи
 
 В `log.txt` всегда можно посмотреть подробную информацию об ошибках. В целях безопасности токены, идентефикаторы резюме и тп затираются.
 
-#### База данных
+### База данных
 
 Данные о работодателях и их вакансиях хранятся в файле `data`. Это обычная база `sqlite3`, вы ее можете просматривать через `DB Browser` и т. п.
 
 Что хранится в базе:
 
-* все просмотренные вакансии;
-* профили работодателей;
-* контакты работодателей;
-* данные об откликах;
-* иные данные, важные для работы.
+- все просмотренные вакансии;
+- профили работодателей;
+- контакты работодателей;
+- данные об откликах;
+- иные данные, важные для работы.
+
+---
 
-### Использование в скриптах
+## Использование в скриптах
 
 Если хотите использовать `hh-applicant-tool` в своих скриптах, то можно это сделать так:
 
@@ -641,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
 ```
 
-### TODO
-
-- Выкинуть ненужный функционал. Например, хранить отзывы нет смысла, так как они нигде не используются
+</details>
 
+---
 
-### Лицензионное соглашение (Limited Non-Commercial License)
+## Лицензионное соглашение (Limited Non-Commercial License)
 
 Данное программное обеспечение распространяется на условиях **ограниченной некоммерческой лицензии**.
 
 - **Разрешённое использование**
-  * **Личное использование и изучение:** Разрешается копирование и модификация кода исключительно для личного ознакомления, обучения и отладки **без права публикации или распространения изменений**.
-  * **Интеграция в программное обеспечение:** Разрешается включение данного кода в состав сторонних бесплатных некоммерческих продуктов **только при полном сохранении исходного кода в неизменном виде**.
-  * **Атрибуция:** Любое распространение, демонстрация или использование кода (в том числе в составе других продуктов) допускается **только при обязательном указании автора и ссылки на оригинальный репозиторий**.
+  - **Личное использование и изучение:** Разрешается копирование и модификация кода исключительно для личного ознакомления, обучения и отладки **без права публикации или распространения изменений**.
+  - **Интеграция в программное обеспечение:** Разрешается включение данного кода в состав сторонних бесплатных некоммерческих продуктов **только при полном сохранении исходного кода в неизменном виде**.
+  - **Атрибуция:** Любое распространение, демонстрация или использование кода (в том числе в составе других продуктов) допускается **только при обязательном указании автора и ссылки на оригинальный репозиторий**.
 
 - **Ограничения на использование**
   **Строго запрещается** использование данного кода в любых коммерческих целях без предварительного письменного согласия автора, включая, но не ограничиваясь:
-    * Интеграцией в платные сервисы, приложения, веб-сайты либо использованием в рамках оказания платных услуг.
-    * Публикацией, распространением или передачей третьим лицам **модифицированных (изменённых) версий** кода.
-    * Перепродажей, сублицензированием либо использованием кода в интересах коммерческих организаций.
+  - Интеграцией в платные сервисы, приложения, веб-сайты либо использованием в рамках оказания платных услуг.
+  - Публикацией, распространением или передачей третьим лицам **модифицированных (изменённых) версий** кода.
+  - Перепродажей, сублицензированием либо использованием кода в интересах коммерческих организаций.
 
 - **Отказ от ответственности**
   Программное обеспечение предоставляется по принципу «как есть» (**AS IS**). Автор не несёт ответственности за любые прямые или косвенные убытки, включая, но не ограничиваясь, блокировкой аккаунтов, потерей данных или иными негативными последствиями, возникшими в результате использования данного программного обеспечения.
 
-
 **© 2023-2026 Sergey M. Все права защищены.**