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

hh_applicant_tool-1.4.12.dist-info/METADATA

@@ -0,0 +1,685 @@
+Metadata-Version: 2.4
+Name: hh-applicant-tool
+Version: 1.4.12
+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
+Requires-Python: >=3.10,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+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)
+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
+
+> Ищу почасовую или проектную [@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)]()
+[![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)]()
+[![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/s3rgeym/hh-applicant-tool)]()
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/hh-applicant-tool)]()
+[![Total Downloads](https://static.pepy.tech/badge/hh-applicant-tool)]()
+
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
+</div>
+
+### ✨ Ключевые преимущества
+
+- 💸 **Полностью бесплатно.** В то время как сервисы в интернете или Telegram с аналогичным функционалом просят за свои услуги от 5.000 до 12.000 рублей в месяц.
+
+- 🔒 **Безопасность личных данных.** Ваши email, телефон, пароль и другие личные данные никуда не передаются в отличие от сторонних сервисов. В этом можно убедиться, изучив [открытый исходный код](https://github.com/s3rgeym/hh-applicant-tool/tree/main/src/hh_applicant_tool). Владельцы сторонних сервисов никогда вам не покажут исходники. Они знают о вас все и эти данные спокойно продадут каким-нибудь жуликам, либо те утекут в результате взлома.
+
+- 💾 **Сохранение контактов и прочей информации.** Контакты работодалей и информация о них и их вакансиях сохраняется в базе данных, что позволяет производить быстрый поиск нужной информации в отличии от сайта.
+
+- 🛡️ **Гарантия от блокировок.** Утилита выполняет запросы с вашего устройства, имитируя обычного пользователя. Сервисы рассылают запросы для сотен аккаунтов с одного сервера, что повышает вероятность блокировки вашего аккаунта до 100%.
+
+- 😎 **Простота в использовании.** С утилитой разберется любой начинающий пользователь компьютера. Настолько, что херки в своем чате уже жалуются на массовые отклики от подростков 14-17 лет, которые успешно освоили данный инструмент.
+
+- 👯 **Мультиаккаунтность и управление резюме.** Вы можете использовать неограниченное количество профилей (аккаунтов), переключаясь между ними через разные файлы конфигурации. Утилита умеет работать со всеми вашими резюме: обновлять их даты публикации и подбирать вакансии под каждое из них.
+
+- 🖥️ **Полноценный CLI и работа на серверах.** Утилита имеет чистый консольный интерфейс. Несмотря на то, что для обхода защиты при авторизации используется браузер, он работает по умолчанию в фоновом (headless) режиме. Для `hh-applicant-tool` не нужна видеокарта или графическая оболочка (X-сервер), что позволяет авторизоваться даже с сервера или из докер-контейнера.
+
+- 🚀 **Скриптинг.** Вы можете использовать утилиту из своих Python-скриптов.
+
+- 🤖 **Борьба с ATS и HR.** Компании уже массово внедрили ATS-системы с нейронными сетями, которые отклоняют ваш отклик в течение 30 секунд. Отказ может прийти из-за отсутствия одного ключевого слова в резюме, это уже не говоря о давно существующих фильтрах по полу, возрасту и даже региону происхождения (безопасники в банках отказывают даже русским, рожденным в Дагестане). Это обесценивает ваши усилия на написание сопроводительных писем и чтение бесконечных портянок бреда, сгенерированных нейронками по запросу каких-то дур. Если тупые кобылы решили себя не утруждать чтением резюме (они сейчас и сами перестали писать), то и вам незачем читать их высеры. Утилита избавляет вас от этой рутины, превращающей поиск работы в полноценную работу. Сейчас доля отказов составляет 98-99%, включая "молчунов", и единственный способ увеличить шансы просто попасть на собеседование — это автоматическая рассылка откликов на все подходящие вакансии.
+
+### Содержание
+
+- [HH Applicant Tool](#hh-applicant-tool)
+  - [✨ Ключевые преимущества](#-ключевые-преимущества)
+  - [Содержание](#содержание)
+  - [Описание](#описание)
+  - [Предыстория](#предыстория)
+  - [Установка](#установка)
+    - [Через Docker](#через-docker)
+    - [Обычная установка](#обычная-установка)
+      - [Установка самой утилиты](#установка-самой-утилиты)
+      - [Установка дополнительных зависимостей](#установка-дополнительных-зависимостей)
+  - [Об авторизации](#об-авторизации)
+  - [Описание команд](#описание-команд)
+  - [Использование AI](#использование-ai)
+    - [OpenAI/ChatGPT](#openaichatgpt)
+  - [Шаблоны сообщений](#шаблоны-сообщений)
+  - [Данные приложения](#данные-приложения)
+    - [Конфигурационный файл](#конфигурационный-файл)
+    - [Логи](#логи)
+    - [База данных](#база-данных)
+  - [Использование в скриптах](#использование-в-скриптах)
+  - [Дополнительные настройки](#дополнительные-настройки)
+  - [TODO](#todo)
+  - [Лицензионное соглашение (Limited Non-Commercial License)](#лицензионное-соглашение-limited-non-commercial-license)
+
+---
+
+### Описание
+
+> Данной утилите похуй на "запрет" доступа к API HH сторонним приложениям, так как она прикидывается официальным приложением под Android
+
+> Утилита для генерации сопроводительного письма может использовать 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» нарушение авторских прав...
+
+Работает с Python >= 3.10. Нужную версию Python можно поставить через
+asdf/pyenv/conda и что-то еще. В школотронской Manjaro и даже в последних Ubuntu
+версия Python новее.
+
+Данная утилита кроссплатформенна. Она гарантированно работает на Linux, Mac и Windows, в т. ч. WSL. При наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
+
+Пример работы:
+
+![image](https://github.com/user-attachments/assets/a0cce1aa-884b-4d84-905a-3bb207eba4a3)
+
+> Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
+
+> Утилита автоматически подхватывает прокси из переменных окружения типа http_proxy или HTTPS_PROXY
+
+### Предыстория
+
+Долгое время я делал массовые заявки с помощью консоли браузера:
+
+```js
+$$('[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` и `docker-compose`:
+
+```sh
+sudo apt install docker.io docker-compose-v2
+```
+
+Выкачиваем репозиторий:
+
+```sh
+git clone https://github.com/s3rgeym/hh-applicant-tool
+```
+
+Переходим в каталог с `docker-compose.yml`:
+
+```sh
+cd hh-applicant-tool/docker
+```
+
+Теперь авторизуйтесь:
+
+```sh
+docker-compose run --rm -it -e TERM=$TERM hh-applicant-tool \
+  hh-applicant-tool -vv -c /app/config 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 up -d
+```
+
+Что будет делать?
+
+- Рассылать отклики со всех опубликованных резюме.
+- Поднимать резюме.
+
+Информацию об ошибках можно посмотреть в файле `config/log.txt`, а контакты работодателей посмотреть в `config/data` с помощью `sqlite3`.
+
+Для остановки выполните:
+
+```sh
+docker-compose down
+```
+
+#### Обычная установка
+
+##### Установка самой утилиты
+
+Универсальный с использованием pipx (требует пакета `python-pipx` в Arch):
+
+```bash
+# Полная версия с поддержкой авторизации, включает Node.js и различные утилиты
+# Обычный пакет без [playwright] можно использовать на сервере, если перенести туда конфиг, и весит
+# он почти на 500МБ меньше. Думаем (c) s3rgeym. Подписаться
+$ pipx install 'hh-applicant-tool[playwright]'
+
+# Если хочется использовать самую последнюю версию, то можно установить ее через git
+$ pipx install "git+https://github.com/s3rgeym/hh-applicant-tool[playwright]"
+
+# Для обновления до новой версии
+$ pipx upgrade hh-applicant-tool
+```
+
+pipx добавляет исполняемый файл `hh-applicant-tool` в `~/.local/bin`, делая эту команду доступной. Путь до `~/.local/bin` должен быть в `$PATH` (в большинстве дистрибутивов он добавлен).
+
+Традиционный способ для Linux/Mac:
+
+```sh
+mkdir -p ~/.venvs
+python -m venv ~/.venvs/hh-applicant-tool
+# Это придется делать постоянно, чтобы команда hh-applicant-tool стала доступна
+.  ~/.venvs/hh-applicant-tool/bin/activate
+pip install 'hh-applicant-tool[playwright]'
+```
+
+Отдельно я распишу процесс установки в **Windows** в подробностях:
+
+- Для начала поставьте последнюю версию **Python 3** любым удобным способом.
+- Запустите **Terminal** или **PowerShell** от Администратора и выполните:
+  ```ps
+  Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
+  ```
+  Данная политика разрешает текущему пользователю (от которого зашли) запускать скрипты. Без нее не будут работать виртуальные окружения.
+
+Далее можно поставить `pipx` и вернуться к инструкции в верху раздела:
+
+- Все так же от администратора выполните:
+  ```ps
+  python -m pip install --user pipx
+  ```
+
+  А затем:
+
+  ```ps
+  python -m pipx ensurepath
+  ```
+
+- Перезапускаем Terminal/Powershell и проверяем:
+
+  ```ps
+  pipx -h
+  ```
+
+С использованием вирт. окружений:
+
+- Создайте и активируйте виртуальное окружение:
+
+  ```ps
+  PS> python -m venv hh-applicant-venv
+  PS> .\hh-applicant-venv\Scripts\activate
+  ```
+
+- Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
+  ```ps
+  (hh-applicant-venv) PS> pip install 'hh-applicant-tool[playwright]'
+  ```
+- Проверьте, работает ли оно:
+  ```ps
+  (hh-applicant-venv) PS> hh-applicant-tool -h
+  ```
+- В случае неудачи вернитесь к первому шагу.
+- Для последующих запусков сначала активируйте виртуальное окружение.
+
+##### Установка дополнительных зависимостей
+
+После вышеописанного нужно установить зависимости в виде Chromium и других средств отладки:
+
+```sh
+$ hh-applicant-tool install
+```
+
+Этот шаг необязателен. Все это нужно только для авторизации.
+
+### Об авторизации
+
+Прямая авторизация:
+
+```bash
+$ hh-applicant-tool authorize '<ваш телефон или email>' -p '<пароль>'
+```
+
+Если вы пропустили пункт про установку зависимостей, то увидите такую ошибку:
+
+```sh
+[E] BrowserType.launch: Executable doesn't exist at...
+```
+
+Если по какой-то причине не был установлен `playwright`:
+
+```sh
+[E] name 'async_playwright' is not defined
+```
+
+
+Если не помните пароль или др. причины, то можно авторизоваться с помощью одноразового кода:
+
+```bash
+$ hh-applicant-tool authorize '<ваш телефон или email>'
+📨 Код был отправлен. Проверьте почту или SMS.
+📩 Введите полученный код: 1387
+🔓 Авторизация прошла успешно!
+```
+
+Если же при вводе правильных данных возникает ошибка авторизации, то, скорее всего, требуется ввод капчи.
+
+Капчу можно ввести через терминал, если тот поддерживает kitty protocol (например, Kitty, Konsole, Ghostty и др):
+
+```sh
+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" />
+
+Ручная авторизация с запуском встроенного браузера:
+
+```sh
+hh-applicant-tool authorize --manual
+```
+
+Проверка авторизации:
+
+```bash
+$ hh-applicant-tool whoami
+🆔 27405918 Кузнецов Андрей Владимирович [ 📄 1 | 👁️ +115 | ✉️ +28 ]
+```
+
+В случае успешной авторизации токены будут сохранены в `config.json`.
+
+Токен доступа выдается на две недели. Он обновляется автоматически. Для его ручного обновления нужно выполнить:
+
+```bash
+$ hh-applicant-tool refresh-token
+```
+
+Помните, что у `refresh_token` тоже есть время жизни, поэтому может потребоваться полная авторизация.
+
+### Описание команд
+
+Примеры команд:
+
+```bash
+# Общий вид: сначала глобальные настройки, затем команда и её аргументы
+$ hh-applicant-tool [options] <operation> [args]
+
+# Справка по глобальным флагам и список операций
+$ hh-applicant-tool -h
+
+# Справка по операции
+$ hh-applicant-tool authorize -h
+
+# Авторизуемся
+$ hh-applicant-tool authorize
+
+# Авторизация с использованием другого профиля
+$ hh-applicant-tool --profile profile123 authorize
+
+# Рассылаем заявки
+$ hh-applicant-tool apply-similar
+
+# Для тестирования поисковой строки и других параметров, используйте --dry-run.
+# С ним отклики не отправляются, а лишь выводятся сообщения
+$ hh-applicant-tool -vv apply-similar --search "Python программист" --per-page 3 --total-pages 1 --dry-run
+
+# Поднимаем резюме
+$ hh-applicant-tool update-resumes
+
+# Ответить работодателям
+$ hh-applicant-tool reply-employers
+
+# Просмотр лога в реальном времени
+$ hh-applicant-tool log -f
+
+# Посмотреть содержимое конфига
+$ hh-applicant-tool config
+
+# Редактировать конфиг в стандартном редакторе
+$ hh-applicant-tool config -e
+
+# Вывести значение из конфига
+$ hh-applicant-tool config -k token.access_token
+
+# Установить значение в конфиге, например, socks-прокси
+$ 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 vacancy_contacts;'
++----------+
+| count(*) |
++----------+
+|    42    |
++----------+
+
+# Экспорт контактов в csv
+$ hh-applicant-tool query 'select * from vacancy_contacts' --csv -o
+contacts.csv
+
+# Выполнение запросов в интерактивном режиме
+$ hh-applicant-tool query
+
+# Чистим отказы
+$ hh-applicant-tool clear-negotiations
+
+# При обновлении может сломаться схема БД, для ее починки нужно выполнить
+# поочерёдно все миграции, добавленные после выхода последней версии
+$ hh-applicant-tool migrate
+List of migrations:
+
+  [1]: 2026-01-07
+
+Choose migration [1] (Keep empty to exit): 1
+✅ Success!
+
+# Вывести все настройки
+$ hh-applicant-tool settings
++----------+-------------------------+-------------------------+
+| Тип      | Ключ                    | Значение                |
++----------+-------------------------+-------------------------+
+| str      | user.email              | dmitry.kozlov@yandex.ru |
+| int      | auth.last_login         | 1768462521              |
++----------+-------------------------+-------------------------+
+
+# Получить значение по ключу
+$ hh-applicant-tool settings auth.username
+
+# Установить email, используемый для автологина
+$ hh-applicant-tool settings auth.username 'user@example.com'
+```
+
+Глобальные настройки:
+
+- `-v` используется для вывода отладочной информации. Два таких флага, например, выводят запросы к **API**.
+- `-c <path>` путь до каталога, где хранятся конфигурации.
+- `--profile <profile-id>` можно указать профиль, данные которого будут храниться в подкаталоге.
+
+| Операция                           | Описание                                                                                                                                                                                                                   |
+| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **authorize**, **auth**            | Авторизация на hh.ru. Введенные логин и пароль "запоминаются" и будут использованы при следующем вызове команды.                                                                                                           |
+| **whoami**, **id**                 | Выводит информацию об авторизованном пользователе                                                                                                                                                                          |
+| **list-resumes**, **list**, **ls** | Список резюме                                                                                                                                                                                                              |
+| **update-resumes**, **update**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                                                                                                                                            |
+| **apply-similar**                  | Откликнуться на все подходящие вакансии СО ВСЕХ РЕЗЮМЕ. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан.                                |
+| **reply-employers**, **reply**     | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ                                                                                                                               |
+| **clear-negotiations**             | Отмена откликов                                                                                                                                                                                                            |
+| **call-api**, **api**              | Вызов произвольного метода API с выводом результата.                                                                                                                                                                       |
+| **refresh-token**, **refresh**     | Обновляет access_token.                                                                                                                                                                                                    |
+| **config**                         | Показывает содержимое конфига. С флагом -e открывает его для редактирования.                                                                                                                                               |
+| **settings**                       | Просмотр и управление настройками в базе данных. Простое key-value хранилище.                                                                                                                                              |
+| **install**                        | Устанавливает зависимости, такие как браузер Chromium, необходимые для авторизации.                                                                                                                                        |
+| **uninstall**                      | Удаляет браузер Chromium, используемый для авторизации.                                                                                                                                                                    |
+| **check-proxy**                    | Проверяет используемые прокси                                                                                                                                                                                              |
+| **migrate**                        | Починить базу                                                                                                                                                                                                              |
+| **query**                          | Выполнение SQL-запросов к базе. Схема БД находится в файле   [schema.sql](./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).
+
+Для тестирования запросов к API используйте команду `call-api` совместно с `jq` для обработки JSON.
+
+Примеры поиска работодателей:
+
+```bash
+$ hh-applicant-tool call-api /employers text="IT" only_with_vacancies=true | jq -r '.items[].alternate_url'
+https://hh.ru/employer/1966364
+https://hh.ru/employer/4679771
+...
+```
+
+Синтаксис `call-api` немного похож на `httpie` или `curlie`:
+
+```sh
+$ hh-applicant-tool call-api [-m {GET|POST|PUT|DELETE}] <endpoint> [<key=value> ...]
+```
+
+Если используется метод `GET` или `DELETE` (или ничего не указано), то параметры будут переданы как query string. Во всех остальных случаях парметры передаются как `application/x-www-form-urlencoded` в теле запроса.
+
+Данная возможность полезна для написания Bash-скриптов.
+
+Документация для работы с API соискателей была удалена с ха-ха.сру и его корпоративного репозитория. Можете не искать, они затерли даже историю репозитория. Но я через веб-архив выкачал документацию. Чтобы ее посмотреть, клонируйте этот репозиторий и откройте файл, например, с помощью [Swagger Viewer](https://marketplace.visualstudio.com/items?itemName=Arjun.swagger-viewer).
+
+<img width="740" height="768" alt="image" src="https://github.com/user-attachments/assets/597fa31e-8bab-48c8-8601-ab9dfc9075b1" />
+
+Так же существуют cli-утилиты:
+
+```sh
+npx @redocly/cli preview -d docs/hhapi
+```
+
+Потом нужно открыть в браузере [http://localhost:4000](http://localhost:4000).
+
+> Отдельные замечания у меня к 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
+
+Для генерации опроводительных писем при откликах и ответа в чаты работодателей (`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": "ВАША_МОДЕЛЬ",
+  }
+}
+```
+
+### Шаблоны сообщений
+
+Команды `apply-similar` и `reply-employers` поддерживают специальный формат сообщений.
+
+Так же в сообщении можно использовать плейсхолдеры:
+
+- **`%(vacancy_name)s`**: Название вакансии.
+- **`%(employer_name)s`**: Название работодателя.
+- **`%(first_name)s`**: Имя пользователя.
+- **`%(last_name)s`**: Фамилия пользователя.
+- **`%(email)s`**: Email пользователя.
+- **`%(phone)s`**: Телефон пользователя.
+- **`%(resume_title)s`**: Название резюме.
+
+Эти плейсхолдеры могут быть использованы в сообщениях для отклика на вакансии, чтобы динамически подставлять соответствующие данные в текст сообщения. Например:
+
+```
+Меня заинтересовала ваша вакансия %(vacancy_name)s. Прошу рассмотреть мою кандидатуру. С уважением, %(first_name)s %(last_name)s.
+```
+
+Так же можно делать текст уникальным с помощью `{}`. Внутри них через `|` перечисляются варианты, один из которых будет случайно выбран:
+
+```
+{Здоров|Привет}, {как {ты|сам}|что делаешь}}?
+```
+
+В итоге получится что-то вроде:
+
+```
+Привет, как ты?
+```
+
+### Данные приложения
+
+Данные приложения хранятся по следующим путям:
+
+| 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` и т. п.
+
+Что хранится в базе:
+
+* все просмотренные вакансии;
+* профили работодателей;
+* контакты работодателей;
+* данные об откликах;
+* иные данные, важные для работы.
+
+### Использование в скриптах
+
+Если хотите использовать `hh-applicant-tool` в своих скриптах, то можно это сделать так:
+
+```python
+from hh_applicant_tool import HHApplicantTool
+
+tool = HHApplicantTool([
+    # Передаем глобальные настройки как обычно
+    "--proxy-url", "socks5://localhost:1080",
+    "--config-path", "/path/to/config"
+])
+
+print(tool.api_client.get('/me'))
+
+# Какую-то вспомогательную информацию можно сохранять в настройках
+import datetime as dt
+
+tool.storage.settings.set_value("_last_script_run", dt.datetime.now())
+
+# Учтите что в таком случае токены, которые могут обновиться при выполнении запросов,
+# нужно сохранять вручную
+tool.save_token()
+```
+
+Команды тоже можно вызывать:
+
+```python
+>>> from hh_applicant_tool import HHApplicantTool
+>>> HHApplicantTool(['authorize', 'your-email@gmail.com']).run()
+📨 Код был отправлен. Проверьте почту или SMS.
+📩 Введите полученный код:
+```
+
+### Дополнительные настройки
+
+Если вы обычный пользователь, то ничего лучше не трогайте.
+
+Отключение проверки версии с выводом предупреждения:
+
+```sh
+$ hh-applicant-tool settings disable_version_check true
+```
+
+Утилита ищет в логах информацию о Python-ошибках. Они отправляются на сервер разработчика с целью их оперативного исправления, однако, вы можете отключить отправку отчетов:
+
+```sh
+$ hh-applicant-tool settings send_error_reports false
+```
+
+### TODO
+
+- Выкинуть ненужный функционал. Например, хранить отзывы нет смысла, так как они нигде не используются
+
+
+### Лицензионное соглашение (Limited Non-Commercial License)
+
+Данное программное обеспечение распространяется на условиях **ограниченной некоммерческой лицензии**.
+
+- **Разрешённое использование**
+  * **Личное использование и изучение:** Разрешается копирование и модификация кода исключительно для личного ознакомления, обучения и отладки **без права публикации или распространения изменений**.
+  * **Интеграция в программное обеспечение:** Разрешается включение данного кода в состав сторонних бесплатных некоммерческих продуктов **только при полном сохранении исходного кода в неизменном виде**.
+  * **Атрибуция:** Любое распространение, демонстрация или использование кода (в том числе в составе других продуктов) допускается **только при обязательном указании автора и ссылки на оригинальный репозиторий**.
+
+- **Ограничения на использование**
+  **Строго запрещается** использование данного кода в любых коммерческих целях без предварительного письменного согласия автора, включая, но не ограничиваясь:
+    * Интеграцией в платные сервисы, приложения, веб-сайты либо использованием в рамках оказания платных услуг.
+    * Публикацией, распространением или передачей третьим лицам **модифицированных (изменённых) версий** кода.
+    * Перепродажей, сублицензированием либо использованием кода в интересах коммерческих организаций.
+
+- **Отказ от ответственности**
+  Программное обеспечение предоставляется по принципу «как есть» (**AS IS**). Автор не несёт ответственности за любые прямые или косвенные убытки, включая, но не ограничиваясь, блокировкой аккаунтов, потерей данных или иными негативными последствиями, возникшими в результате использования данного программного обеспечения.
+
+
+**© 2023-2026 Sergey M. Все права защищены.**
+