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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,333 +0,0 @@
1
- Metadata-Version: 2.3
2
- Name: hh-applicant-tool
3
- Version: 0.6.3
4
- Summary:
5
- Author: Senior YAML Developer
6
- Author-email: yamldeveloper@proton.me
7
- Requires-Python: >=3.10,<4.0
8
- Classifier: Programming Language :: Python :: 3
9
- Classifier: Programming Language :: Python :: 3.10
10
- Classifier: Programming Language :: Python :: 3.11
11
- Classifier: Programming Language :: Python :: 3.12
12
- Classifier: Programming Language :: Python :: 3.13
13
- Provides-Extra: qt
14
- Requires-Dist: prettytable (>=3.6.0,<4.0.0)
15
- Requires-Dist: pyqt6 (==6.7.0) ; extra == "qt"
16
- Requires-Dist: pyqt6-webengine (==6.7.0) ; extra == "qt"
17
- Requires-Dist: requests[socks] (>=2.32.3,<3.0.0)
18
- Description-Content-Type: text/markdown
19
-
20
- ## HH Applicant Tool
21
-
22
- ![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg)
23
- [![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)]()
24
- [![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)]()
25
- [![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/s3rgeym/hh-applicant-tool)]()
26
- [![PyPI - Downloads](https://img.shields.io/pypi/dm/hh-applicant-tool)]()
27
- [![Total Downloads](https://static.pepy.tech/badge/hh-applicant-tool)]()
28
-
29
- <div align="center">
30
- <img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
31
- </div>
32
-
33
- ### Описание
34
-
35
- > Утилита для генерации сопроводительного письма может использовать AI
36
-
37
- Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита сохраняет контактные данные, всех кто вам писал, и позволяет вам по ним проводить поиск (название компании, сайт и тп). Это удобно, так как контакт сохранится даже, если вышлют отказ в дальнейшем. У утилиты есть группа: [HH Resume Automate](https://t.me/hh_resume_automate).
38
-
39
- Работает с Python >= 3.10. Нужную версию Python можно поставить через
40
- asdf/pyenv/conda и что-то еще. В школотронской Manjaro и даже в последних Ubuntu
41
- версия Python новее.
42
-
43
- Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести конфиг на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
44
-
45
- Пример работы:
46
-
47
- ![image](https://github.com/user-attachments/assets/a0cce1aa-884b-4d84-905a-3bb207eba4a3)
48
-
49
- > Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
50
-
51
- ### Внимание!!!
52
-
53
- Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/). Оно обладает минимальным функционалом: обновление резюме (одного) и рассылка откликов (чистить их и тп нельзя).
54
-
55
- ### Предыстория
56
-
57
- Долгое время я делал массовые заявки с помощью консоли браузера:
58
-
59
- ```js
60
- $$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
61
- ```
62
-
63
- Оно работает, хоть и не идеально. Я даже пробовал автоматизировать рассылки через `p[yu]ppeeter`, пока не прочитал [документацию](https://github.com/hhru/api). И не обнаружил, что **API** (интерфейс) содержит все необходимые мне методы. Headhunter позволяет создать свое приложение, но там ручная модерация, и наврядли кто-то разрешит мне создать приложение для спама заявками. Я [декомпилировал](https://gist.github.com/s3rgeym/eee96bbf91b04f7eb46b7449f8884a00) официальное приложение для **Android** и получил **CLIENT_ID** и **CLIENT_SECRET**, необходимые для работы через **API**.
64
-
65
- ### Установка
66
-
67
- ```bash
68
- # Версия с поддержкой авторизации через запуск окна с браузером (эта версия очень много весит)
69
- # Можно использовать обычный pip
70
- $ pipx install 'hh-applicant-tool[qt]'
71
-
72
- # Если хочется использовать самую последнюю версию, то можно установить ее через git
73
- $ pipx install git+https://github.com/s3rgeym/hh-applicant-tool
74
-
75
- # Для обновления до новой версии
76
- $ pipx upgrade hh-applicant-tool
77
- ```
78
-
79
- Отдельно я распишу процесс установки в **Windows** в подробностях:
80
-
81
- * Для начала поставьте последнюю версию **Python 3** любым удобным способом.
82
- * Запустите **Terminal** или **PowerShell** от Администратора и выполните:
83
- ```ps
84
- Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
85
- ```
86
- Данная политика разрешает текущему пользователю (от которого зашли) запускать скрипты. Без нее не будут работать виртуальные окружения.
87
- * Создайте и активируйте виртуальное окружение:
88
- ```ps
89
- PS> python -m venv hh-applicant-venv
90
- PS> .\hh-applicant-venv\Scripts\activate
91
- ```
92
- * Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
93
- ```ps
94
- (hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
95
- ```
96
- * Проверьте работает ли оно:
97
- ```ps
98
- (hh-applicant-venv) PS> hh-applicant-tool -h
99
- ```
100
- * В случае неудачи вернитесь к первому шагу.
101
- * Для последующих запусков сначала активируйте виртуальное окружение.
102
-
103
- ### Авторизация
104
-
105
- ```bash
106
- $ hh-applicant-tool -vv authorize
107
- ```
108
-
109
- ![image](https://github.com/user-attachments/assets/88961e31-4ea3-478f-8c43-914d6785bc3b)
110
-
111
- > В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
112
-
113
- Проверка авторизации:
114
-
115
- ```bash
116
- $ hh-applicant-tool whoami
117
- {
118
- "auth_type": "applicant",
119
- "counters": {
120
- "new_resume_views": 1488,
121
- "resumes_count": 1,
122
- "unread_negotiations": 228
123
- },
124
- "email": "vasya.pupkin@gmail.com",
125
- "employer": null,
126
- "first_name": "Вася",
127
- "id": "1234567890",
128
- "is_admin": false,
129
- "is_anonymous": false,
130
- "is_applicant": true,
131
- "is_application": false,
132
- "is_employer": false,
133
- "is_in_search": true,
134
- "last_name": "Пупкин",
135
- "manager": null,
136
- "mid_name": null,
137
- "middle_name": null,
138
- "negotiations_url": "https://api.hh.ru/negotiations",
139
- "personal_manager": null,
140
- "phone": "79012345678",
141
- "profile_videos": {
142
- "items": []
143
- },
144
- "resumes_url": "https://api.hh.ru/resumes/mine"
145
- }
146
- ```
147
-
148
- В случае успешной авторизации токены будут сохранены в `config.json`:
149
-
150
- ```json
151
- {
152
- "token": {
153
- "access_token": "...",
154
- "created_at": 1678151427,
155
- "expires_in": 1209599,
156
- "refresh_token": "...",
157
- "token_type": "bearer"
158
- }
159
- }
160
- ```
161
-
162
- Токен доступа выдается на две недели. После его нужно обновить:
163
-
164
- ```bash
165
- $ hh-applicant-tool refresh-token
166
- ```
167
-
168
- ### Пути до файла config.json
169
-
170
- | OS | Путь |
171
- |----------------------------|---------------------------------------------------------------------|
172
- | **Windows** | `C:\Users\%username%\AppData\Roaming\hh-applicant-tool\config.json` |
173
- | **macOS** | `~/Library/Application Support/hh-applicant-tool/config.json` |
174
- | **Linux** | `~/.config/hh-applicant-tool/config.json` |
175
-
176
- Полный путь до конфигурационного файла можно вывести с помощью команды:
177
-
178
- ```bash
179
- hh-applicant-tool config -p
180
- ```
181
-
182
- Через конфиг можно задать дополнительные настройки:
183
-
184
- | Имя атрибута | Описание |
185
- | --- | --- |
186
- | `user_agent` | Кастомный юзерагент, передаваемый при кажом запросе. |
187
- | `proxy_url` | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050` |
188
- | `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений |
189
-
190
- ### Описание команд
191
-
192
- ```bash
193
- $ hh-applicant-tool [ GLOBAL_FLAGS ] [ OPERATION [ OPERATION_FLAGS ] ]
194
-
195
- # Справка по глобальным флагам и список операций
196
- $ hh-applicant-tool -h
197
-
198
- # Справка по операции
199
- $ hh-applicant-tool apply-similar -h
200
-
201
- # Авторизуемся
202
- $ hh-applicant-tool authorize
203
-
204
- # Рассылаем заявки
205
- $ hh-applicant-tool apply-similar
206
-
207
- # Поднимаем резюме
208
- $ hh-applicant-tool update-resumes
209
-
210
- # Чистим заявки и баним за отказы говноконторы
211
- $ hh-applicant-tool clear-negotiations --blacklist-discard
212
-
213
- # Экспортировать в HTML, контакты работодателей, которые когда-либо высылали вам
214
- # приглашение
215
- $ hh-applicant-tool get-employer-contacts --export -f html > report.html
216
- ```
217
-
218
- Можно вызвать любой метод API:
219
-
220
- ```bash
221
- $ hh-applicant-tool call-api /employers text="IT" only_with_vacancies=true | jq -r '.items[].alternate_url'
222
- https://hh.ru/employer/1966364
223
- https://hh.ru/employer/4679771
224
- https://hh.ru/employer/8932785
225
- https://hh.ru/employer/9451699
226
- https://hh.ru/employer/766478
227
- https://hh.ru/employer/4168187
228
- https://hh.ru/employer/9274777
229
- https://hh.ru/employer/1763330
230
- https://hh.ru/employer/5926815
231
- https://hh.ru/employer/1592535
232
- https://hh.ru/employer/9627641
233
- https://hh.ru/employer/4073857
234
- https://hh.ru/employer/2667859
235
- https://hh.ru/employer/4053700
236
- https://hh.ru/employer/5190600
237
- https://hh.ru/employer/607484
238
- https://hh.ru/employer/9386615
239
- https://hh.ru/employer/80660
240
- https://hh.ru/employer/6078902
241
- https://hh.ru/employer/1918903
242
- ```
243
-
244
- Данная возможность полезна для написания Bash-скриптов.
245
-
246
- Глобальные флаги:
247
-
248
- - `-v` используется для вывода отладочной информации. Два таких флага, например, выводят запросы к **API**.
249
- - `-c <path>` можно создать путь до конфига. С помощью этого флага можно одновременно использовать несколько профилей.
250
-
251
- | Операция | Описание |
252
- | ---------------------- | --------------------------------------------------------------------------------------------------- |
253
- | **authorize** | Открывает сайт hh.ru для авторизации и перехватывает перенаправление на `hhadnroid://oauthresponse` |
254
- | **whoami** | Выводит информацию об авторизованном пользователе |
255
- | **list-resumes** | Список резюме |
256
- | **update-resumes** | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату». |
257
- | **apply-similar** | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан. |
258
- | **reply-employers** | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ |
259
- | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят |
260
- | **call-api** | Вызов произвольного метода API с выводом результата. |
261
- | **refresh-token** | Обновляет access_token. |
262
- | **config** | Редактировать конфигурационный файл. |
263
- | **get-employer-contacts** | Получить список полученных вами контактов работодателей. Поддерживается так же экспорт в html/jsonl. Если хотите собирать контакты с нескольких акков, то укажите им одинаковый `client_telemetry_id` в конфигах. |
264
- | **delete-telemetry** | Удадяет телеметрию, если та была включена. |
265
-
266
- ### Формат текста сообщений
267
-
268
- Команда `apply-similar` поддерживает специальный формат сообщений.
269
-
270
- Так же в сообщении можно использовать плейсхолдеры:
271
-
272
- - **`%(vacancy_name)s`**: Название вакансии.
273
- - **`%(employer_name)s`**: Название работодателя.
274
- - **`%(first_name)s`**: Имя пользователя.
275
- - **`%(last_name)s`**: Фамилия пользователя.
276
- - **`%(email)s`**: Email пользователя.
277
- - **`%(phone)s`**: Телефон пользователя.
278
-
279
- Эти плейсхолдеры могут быть использованы в сообщениях для отклика на вакансии, чтобы динамически подставлять соответствующие данные в текст сообщения. Например:
280
-
281
- ```
282
- Меня заинтересовала ваша вакансия %(vacancy_name)s. Прошу рассмотреть мою кандидатуру. С уважением, %(first_name)s %(last_name)s.
283
- ```
284
-
285
- Так же можно делать текст уникальным с помощью `{}`. Внутри них через `|` перечисляются варианты, один из которых будет случайно выбран:
286
-
287
- ```
288
- {Здоров|Привет}, {как {ты|сам}|что делаешь}?
289
- ```
290
-
291
- В итоге получится что-то типа:
292
-
293
- ```
294
- Привет, как ты?
295
- ```
296
-
297
- ### Использование AI для генерации сопроводительного письма
298
-
299
- * Перейдите на сайт [blackbox.ai](https://www.blackbox.ai) и создайте чат.
300
- * В первом сообщении опишите свой опыт и тп.
301
- * Далее откройте devtools, нажав `F12`.
302
- * Во вкладке `Network` последним должен быть POST-запрос на `https://www.blackbox.ai/api/chat`.
303
- * Запустите редактирование конфига:
304
- ```sh
305
- hh-applicant-tool config
306
- ```
307
- * Измените конфиг:
308
- ```json
309
- {
310
- // ...
311
- "blackbox": {
312
- "session_id": "<В заголовках запроса найдите Cookie, скопируйте сюда значение sessionId до ;>",
313
- "chat_payload": <Сюда вставьте тело запроса типа {"messages":[{"id":"IXqdOx9","content":"Я программист fullstack-разработчик...","role":"user"}],"id":"IXqdOx9","previewToken":null,"userId":null,...,"webSearchModePrompt":false,"deepSearchMode":false}>
314
- }
315
- }
316
- ```
317
- * Пример рассылки откликов с генерированным письмом:
318
- ```sh
319
- hh-applicant-tool apply-similar -f --ai
320
- ```
321
-
322
- ### Написание плагинов
323
-
324
- Утилита использует систему плагинов. Все они лежат в [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).
325
-
326
- Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
327
-
328
- Для создания своих плагинов прочитайте документацию:
329
-
330
- * [HH.RU OpenAPI](https://api.hh.ru/openapi/redoc)
331
-
332
- Для тестирования запросов к API используйте команду `call-api` и `jq` для вывода JSON в удобочитаемом формате.
333
-
@@ -1,32 +0,0 @@
1
- hh_applicant_tool/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
2
- hh_applicant_tool/__main__.py,sha256=cwKJAAML0RRKT9Qbzcwf07HHcuSd8oh7kx4P1apndWQ,84
3
- hh_applicant_tool/ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
4
- hh_applicant_tool/ai/blackbox.py,sha256=vqkEpsX7q7bgX49dmmifYJmrbuz_WBg5u9M9J9XdQlI,1670
5
- hh_applicant_tool/api/__init__.py,sha256=kgFSHibRaAugN2BA3U1djEa20qgKJUUVouwJzjEB0DU,84
6
- hh_applicant_tool/api/client.py,sha256=-nQMX_KY2zcV98CtBqq7BHyseDs5LglhHoMF1C7Oi4M,9895
7
- hh_applicant_tool/api/errors.py,sha256=Rd1XE2OTtZDa3GDqght2LtOnTHWtOx7Zsow87nn4x4A,1807
8
- hh_applicant_tool/color_log.py,sha256=gN6j1Ayy1G7qOMI_e3WvfYw_ublzeQbKgsVLhqGg_3s,823
9
- hh_applicant_tool/constants.py,sha256=KV_jowi21ToMp8yqF1vWolnVZb8nAC3rYRkcFJ71m-Q,759
10
- hh_applicant_tool/jsonc.py,sha256=QNS4gRHfi7SAeOFnffAIuhH7auC4Y4HAkmH12eX5PkI,4002
11
- hh_applicant_tool/main.py,sha256=A4YPkNXAdZY0GoGm0iigiQtzXTrpR3SaIGo54q9-Dd0,5652
12
- hh_applicant_tool/mixins.py,sha256=8VoyrNgdlljy6pLTSFGJOYd9kagWT3yFOZYIGR6MEbI,425
13
- hh_applicant_tool/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
14
- hh_applicant_tool/operations/apply_similar.py,sha256=EXY7LXuUGx5CjbHG22bR2-22gG3c--IniQjreHTG1pY,15568
15
- hh_applicant_tool/operations/authorize.py,sha256=NYrxe6oemUBcDHioT1t1lJmi9l45V4ZXzQPD_-nf6hk,3328
16
- hh_applicant_tool/operations/call_api.py,sha256=o3GZgtqk6w4zpCm-JTHVjFrKVOwW-vsu1HdRi-hqAjo,1423
17
- hh_applicant_tool/operations/clear_negotiations.py,sha256=mu9nBdP7b_dlEMQk88w0IWX1lNTTFqnWbS1tCO1Mlws,4329
18
- hh_applicant_tool/operations/config.py,sha256=BzGWbHwNlXIpYHxnZUidDZTk1-7GZb8UL-asy8w4uN4,1390
19
- hh_applicant_tool/operations/delete_telemetry.py,sha256=JHdh_l7IJL_qy5AIIy8FQpUupmH60D3a6zjfEVKkT2U,986
20
- hh_applicant_tool/operations/get_employer_contacts.py,sha256=Sd-x3O08bmKm1OGVLtJ6rcPZ_j1jwjlqKV4z1n_G-38,9918
21
- hh_applicant_tool/operations/list_resumes.py,sha256=dILHyBCSEVqdNAvD8SML5f2Lau1R2AzTaKE9B4FG8Wg,1109
22
- hh_applicant_tool/operations/refresh_token.py,sha256=v_Fcw9mCfOdE6MLTCQjZQudhJPX0fup3k0BaIM394Qw,834
23
- hh_applicant_tool/operations/reply_employers.py,sha256=eJlVuliQO_fy7_sBj-1RqgjphqbqP_yejbNFVxiUhNM,13426
24
- hh_applicant_tool/operations/update_resumes.py,sha256=_r7HA_vpYMs5DFY-mVP1ZRG9bggsv7ebKYrwteBmJ30,1053
25
- hh_applicant_tool/operations/whoami.py,sha256=pNWJMmEQLBk3U6eiGz4CHcX7eXzDXcfezFjX7zLjqyA,711
26
- hh_applicant_tool/telemetry_client.py,sha256=1EKZWc5kMx2yERW9SrR9vaf-OB6M_KKcMXeicH5YyY0,3834
27
- hh_applicant_tool/types.py,sha256=q3yaIcq-UOkPzjxws0OFa4w9fTty-yx79_dic70_dUM,843
28
- hh_applicant_tool/utils.py,sha256=3T4A2AykGqTwtGAttmYplIjHwFl3pNAcbWIVuA-OheQ,3080
29
- hh_applicant_tool-0.6.3.dist-info/METADATA,sha256=kBijByhrEeWXEBq6dNd6Y4x_LScU9kC1dW-_yPWhSFo,20600
30
- hh_applicant_tool-0.6.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
31
- hh_applicant_tool-0.6.3.dist-info/entry_points.txt,sha256=Vb7M2YaYLMtKYJZh8chIrXZApMzSRFT1-rQw-U9r10g,65
32
- hh_applicant_tool-0.6.3.dist-info/RECORD,,