hh-applicant-tool 0.7.7__tar.gz
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.
- hh_applicant_tool-0.7.7/PKG-INFO +436 -0
- hh_applicant_tool-0.7.7/README.md +413 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/__init__.py +0 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/__main__.py +6 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/ai/__init__.py +0 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/ai/blackbox.py +55 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/ai/openai.py +71 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/api/__init__.py +3 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/api/client.py +279 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/api/errors.py +90 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/color_log.py +47 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/constants.py +14 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/jsonc.py +143 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/main.py +196 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/mixins.py +13 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/__init__.py +0 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/apply_similar.py +601 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/authorize.py +132 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/call_api.py +43 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/clear_negotiations.py +109 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/config.py +49 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/delete_telemetry.py +30 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/get_employer_contacts.py +322 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/list_resumes.py +39 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/refresh_token.py +29 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/reply_employers.py +324 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/update_resumes.py +32 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/operations/whoami.py +25 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/telemetry_client.py +106 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/types.py +45 -0
- hh_applicant_tool-0.7.7/hh_applicant_tool/utils.py +119 -0
- hh_applicant_tool-0.7.7/pyproject.toml +44 -0
|
@@ -0,0 +1,436 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: hh-applicant-tool
|
|
3
|
+
Version: 0.7.7
|
|
4
|
+
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.
|
|
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
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
14
|
+
Provides-Extra: qt
|
|
15
|
+
Requires-Dist: prettytable (>=3.6.0,<4.0.0)
|
|
16
|
+
Requires-Dist: pyqt6 (==6.7.0) ; extra == "qt"
|
|
17
|
+
Requires-Dist: pyqt6-webengine (==6.7.0) ; extra == "qt"
|
|
18
|
+
Requires-Dist: requests[socks] (>=2.32.3,<3.0.0)
|
|
19
|
+
Project-URL: Homepage, https://github.com/s3rgeym/hh-applicant-tool
|
|
20
|
+
Project-URL: Repository, https://github.com/s3rgeym/hh-applicant-tool
|
|
21
|
+
Description-Content-Type: text/markdown
|
|
22
|
+
|
|
23
|
+
## HH Applicant Tool
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
[]()
|
|
27
|
+
[]()
|
|
28
|
+
[]()
|
|
29
|
+
[]()
|
|
30
|
+
[]()
|
|
31
|
+
|
|
32
|
+
<div align="center">
|
|
33
|
+
<img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
|
|
34
|
+
</div>
|
|
35
|
+
|
|
36
|
+
### Содержание
|
|
37
|
+
|
|
38
|
+
* [🚀 Описание](#описание)
|
|
39
|
+
* [⚠️ Внимание](#внимание)
|
|
40
|
+
* [📜 Предыстория](#предыстория)
|
|
41
|
+
* [📦 Установка](#установка)
|
|
42
|
+
* [🔑 Авторизация](#авторизация)
|
|
43
|
+
* [⚙️ Конфигурация](#пути-до-файла-configjson)
|
|
44
|
+
* [🛠 Описание команд](#описание-команд)
|
|
45
|
+
* [📝 Формат сообщений](#формат-текста-сообщений)
|
|
46
|
+
* [🤖 Использование AI (ChatGPT)](#использование-ai-для-генерации-сопроводительного-письма)
|
|
47
|
+
* [📡 Работа с API напрямую](#работа-с-api-напрямую)
|
|
48
|
+
* [🔌 Добавление своих команд](#добавление-своих-команд)
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
### Описание
|
|
53
|
+
|
|
54
|
+
> Данной утилите похуй на "запрет" доступа к API HH сторонним приложениям, так как она прикидывается официальным приложением под Android
|
|
55
|
+
|
|
56
|
+
> Утилита для генерации сопроводительного письма может использовать AI в тч ChatGPT. Подробное описание ниже
|
|
57
|
+
|
|
58
|
+
Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита сохраняет контактные данные, всех кто вам писал, и позволяет вам по ним проводить поиск (название компании, сайт и тп). Это удобно, так как контакт сохранится даже, если вышлют отказ в дальнейшем. Огромной проблемой являются мошенники на Ха-Ха, притворяющиеся раб-о-тодателями. Так как утилитой пользуются сотни людей, делящихся информацией о работодателях, то очень легко вычислить, что менеджеры работодателей постоянно меняют телефонные номера (вы видите номера только тех, кто вас пригласил). В России в рамках борьбы с нежелательными звонками, номера с которых по 20-30 раз в день звонят тем, кого нет в контактах, блокируют. Поэтому мошенники каждые 2-3 дня изменяют номер телефона в настройках на сайте. Иногда блокируются и номера овчарок, но в таких случаях идет речь о разного рода аутсорсерах/интеграторах, которые перепродают вас с наценкой 200-300-500%, которая вся достается какому-то успешному кабанчику, они ничем в принципе не отличаясь от жуликов. Утилита такие контакты помечает как мошеннические, чтобы вы не тратили время на заполнение анкет, написание сообщений или звонки ублюдкам (ниже есть пример блокировки мошенников). Мой совет: скрывайте свой номер от работодателя, если рассылаете отклики через утилиту, а то количество жуликов на красном сайте мягко говоря зашкаливает. У утилиты есть канал в пашкограме: [HH Applicant Tool](https://t.me/hh_applicant_tool). Старый <s>[HH Resume Automate](https://t.me/hh_resume_automate)</s> был выпилен какими-то долбоебами, углядевшими во флаге Японии с двумя буквами h нарушение авторских прав...
|
|
59
|
+
|
|
60
|
+
<img width="1024" height="1024" alt="image" src="https://github.com/user-attachments/assets/c17e17db-f5d1-4215-bc62-32b0581e8357" />
|
|
61
|
+
|
|
62
|
+
> Утилита предупреждает о подозрительных работодателях, с высокой вероятностью являющихся мошенниками
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
Работает с Python >= 3.10. Нужную версию Python можно поставить через
|
|
66
|
+
asdf/pyenv/conda и что-то еще. В школотронской Manjaro и даже в последних Ubuntu
|
|
67
|
+
версия Python новее.
|
|
68
|
+
|
|
69
|
+
Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести конфиг на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
|
|
70
|
+
|
|
71
|
+
Пример работы:
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
> Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
|
|
76
|
+
|
|
77
|
+
### Внимание!!!
|
|
78
|
+
|
|
79
|
+
Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/). Оно обладает минимальным функционалом: обновление резюме (одного) и рассылка откликов (чистить их и тп нельзя).
|
|
80
|
+
|
|
81
|
+
### Предыстория
|
|
82
|
+
|
|
83
|
+
Долгое время я делал массовые заявки с помощью консоли браузера:
|
|
84
|
+
|
|
85
|
+
```js
|
|
86
|
+
$$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
Оно работает, хоть и не идеально. Я даже пробовал автоматизировать рассылки через `p[yu]ppeeter`, пока не прочитал [документацию](https://github.com/hhru/api). И не обнаружил, что **API** (интерфейс) содержит все необходимые мне методы. Headhunter позволяет создать свое приложение, но там ручная модерация, и наврядли кто-то разрешит мне создать приложение для спама заявками. Я [декомпилировал](https://gist.github.com/s3rgeym/eee96bbf91b04f7eb46b7449f8884a00) официальное приложение для **Android** и получил **CLIENT_ID** и **CLIENT_SECRET**, необходимые для работы через **API**.
|
|
90
|
+
|
|
91
|
+
### Установка
|
|
92
|
+
|
|
93
|
+
Универсальный с использованием pipx (требует пакета `python-pipx` в Arch):
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
# Версия с поддержкой авторизации через запуск окна с браузером (эта версия очень много весит)
|
|
97
|
+
# Можно использовать обычный pip
|
|
98
|
+
$ pipx install 'hh-applicant-tool[qt]'
|
|
99
|
+
|
|
100
|
+
# Если хочется использовать самую последнюю версию, то можно установить ее через git
|
|
101
|
+
$ pipx install git+https://github.com/s3rgeym/hh-applicant-tool
|
|
102
|
+
|
|
103
|
+
# Для обновления до новой версии
|
|
104
|
+
$ pipx upgrade hh-applicant-tool
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
pipx добавляет исполняемый файл `hh-appplicant-tool` в `~/.local/bin`, делая эту команду доступной. Путь до `~/.local/bin` должен быть в `$PATH` (в большинстве дистрибутивов он добавлен).
|
|
108
|
+
|
|
109
|
+
Традиционный способ для Linux/Mac:
|
|
110
|
+
|
|
111
|
+
```sh
|
|
112
|
+
mkdir -p ~/.venvs
|
|
113
|
+
python -m venv ~/.venvs/hh-applicant-tool
|
|
114
|
+
# Это придется делать постоянно, чтобы команда hh-applicant-tool стала доступна
|
|
115
|
+
. ~/.venvs/hh-applicant-tool/bin/activate
|
|
116
|
+
pip install 'hh-applicant-tool[qt]'
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Отдельно я распишу процесс установки в **Windows** в подробностях:
|
|
120
|
+
|
|
121
|
+
- Для начала поставьте последнюю версию **Python 3** любым удобным способом.
|
|
122
|
+
- Запустите **Terminal** или **PowerShell** от Администратора и выполните:
|
|
123
|
+
```ps
|
|
124
|
+
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
|
|
125
|
+
```
|
|
126
|
+
Данная политика разрешает текущему пользователю (от которого зашли) запускать скрипты. Без нее не будут работать виртуальные окружения.
|
|
127
|
+
- Создайте и активируйте виртуальное окружение:
|
|
128
|
+
|
|
129
|
+
```ps
|
|
130
|
+
PS> python -m venv hh-applicant-venv
|
|
131
|
+
PS> .\hh-applicant-venv\Scripts\activate
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
- Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
|
|
135
|
+
```ps
|
|
136
|
+
(hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
|
|
137
|
+
```
|
|
138
|
+
- Проверьте работает ли оно:
|
|
139
|
+
```ps
|
|
140
|
+
(hh-applicant-venv) PS> hh-applicant-tool -h
|
|
141
|
+
```
|
|
142
|
+
- В случае неудачи вернитесь к первому шагу.
|
|
143
|
+
- Для последующих запусков сначала активируйте виртуальное окружение.
|
|
144
|
+
|
|
145
|
+
### Авторизация
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
$ hh-applicant-tool -vv authorize
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
<img width="610" height="958" alt="image" src="https://github.com/user-attachments/assets/adf47113-df16-4500-aed5-a78d9a783d97" />
|
|
152
|
+
|
|
153
|
+
> Пусть надпись "Поиск содрудников" не вводит в заблуждение — это форма авторизации соискателей. Просто есть долбоебы, которые в этом окне начинают лихорадочно тыкать по ссылкам, не понимая, что форма авторизации у них была перед носом.
|
|
154
|
+
|
|
155
|
+
> В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
|
|
156
|
+
|
|
157
|
+
Проверка авторизации:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
$ hh-applicant-tool whoami
|
|
161
|
+
{
|
|
162
|
+
"auth_type": "applicant",
|
|
163
|
+
"counters": {
|
|
164
|
+
"new_resume_views": 1488,
|
|
165
|
+
"resumes_count": 1,
|
|
166
|
+
"unread_negotiations": 228
|
|
167
|
+
},
|
|
168
|
+
"email": "vasya.pupkin@gmail.com",
|
|
169
|
+
"employer": null,
|
|
170
|
+
"first_name": "Вася",
|
|
171
|
+
"id": "1234567890",
|
|
172
|
+
"is_admin": false,
|
|
173
|
+
"is_anonymous": false,
|
|
174
|
+
"is_applicant": true,
|
|
175
|
+
"is_application": false,
|
|
176
|
+
"is_employer": false,
|
|
177
|
+
"is_in_search": true,
|
|
178
|
+
"last_name": "Пупкин",
|
|
179
|
+
"manager": null,
|
|
180
|
+
"mid_name": null,
|
|
181
|
+
"middle_name": null,
|
|
182
|
+
"negotiations_url": "https://api.hh.ru/negotiations",
|
|
183
|
+
"personal_manager": null,
|
|
184
|
+
"phone": "79012345678",
|
|
185
|
+
"profile_videos": {
|
|
186
|
+
"items": []
|
|
187
|
+
},
|
|
188
|
+
"resumes_url": "https://api.hh.ru/resumes/mine"
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
В случае успешной авторизации токены будут сохранены в `config.json`:
|
|
193
|
+
|
|
194
|
+
```json
|
|
195
|
+
{
|
|
196
|
+
"token": {
|
|
197
|
+
"access_token": "...",
|
|
198
|
+
"created_at": 1678151427,
|
|
199
|
+
"expires_in": 1209599,
|
|
200
|
+
"refresh_token": "...",
|
|
201
|
+
"token_type": "bearer"
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
Токен доступа выдается на две недели. Он обновляется автоматически. Для его ручного обновления нужно выполнить:
|
|
207
|
+
|
|
208
|
+
```bash
|
|
209
|
+
$ hh-applicant-tool refresh-token
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Помните, что у `refresh_token` тоже есть время жизни, поэтому может потребоваться полная авторизация.
|
|
213
|
+
|
|
214
|
+
### Пути до файла config.json
|
|
215
|
+
|
|
216
|
+
| OS | Путь |
|
|
217
|
+
| ----------- | ------------------------------------------------------------------- |
|
|
218
|
+
| **Windows** | `C:\Users\%username%\AppData\Roaming\hh-applicant-tool\config.json` |
|
|
219
|
+
| **macOS** | `~/Library/Application Support/hh-applicant-tool/config.json` |
|
|
220
|
+
| **Linux** | `~/.config/hh-applicant-tool/config.json` |
|
|
221
|
+
|
|
222
|
+
Полный путь до конфигурационного файла можно вывести с помощью команды:
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
hh-applicant-tool config -p
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
Через конфиг можно задать дополнительные настройки:
|
|
229
|
+
|
|
230
|
+
| Имя атрибута | Описание |
|
|
231
|
+
| --------------- | ------------------------------------------------------------------------------------------ |
|
|
232
|
+
| `proxy_url` | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050` |
|
|
233
|
+
| `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений |
|
|
234
|
+
| `user_agent` | Кастомный юзерагент, передаваемый при каждом запросе. По умолчанию используется от Android |
|
|
235
|
+
| `client_id` | Идентификатор клиента, используемый для авторизации. По умолчанию используется от Android |
|
|
236
|
+
| `client_secret` | Секретный ключ клиента, используемый для авторизации. По умолчанию используется от Android |
|
|
237
|
+
|
|
238
|
+
### Описание команд
|
|
239
|
+
|
|
240
|
+
```bash
|
|
241
|
+
$ hh-applicant-tool [ GLOBAL_FLAGS ] [ OPERATION [ OPERATION_FLAGS ] ]
|
|
242
|
+
|
|
243
|
+
# Справка по глобальным флагам и список операций
|
|
244
|
+
$ hh-applicant-tool -h
|
|
245
|
+
|
|
246
|
+
# Справка по операции
|
|
247
|
+
$ hh-applicant-tool apply-similar -h
|
|
248
|
+
|
|
249
|
+
# Авторизуемся
|
|
250
|
+
$ hh-applicant-tool authorize
|
|
251
|
+
|
|
252
|
+
# Рассылаем заявки
|
|
253
|
+
$ hh-applicant-tool apply-similar
|
|
254
|
+
|
|
255
|
+
# Поднимаем резюме
|
|
256
|
+
$ hh-applicant-tool update-resumes
|
|
257
|
+
|
|
258
|
+
# Чистим заявки и баним за отказы говноконторы
|
|
259
|
+
$ hh-applicant-tool clear-negotiations --blacklist-discard
|
|
260
|
+
|
|
261
|
+
# Экспортировать в HTML, контакты работодателей, которые когда-либо высылали вам
|
|
262
|
+
# приглашение
|
|
263
|
+
$ hh-applicant-tool get-employer-contacts --export -f html > report.html
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
Можно вызвать любой метод API:
|
|
267
|
+
|
|
268
|
+
```bash
|
|
269
|
+
$ hh-applicant-tool call-api /employers text="IT" only_with_vacancies=true | jq -r '.items[].alternate_url'
|
|
270
|
+
https://hh.ru/employer/1966364
|
|
271
|
+
https://hh.ru/employer/4679771
|
|
272
|
+
https://hh.ru/employer/8932785
|
|
273
|
+
https://hh.ru/employer/9451699
|
|
274
|
+
https://hh.ru/employer/766478
|
|
275
|
+
https://hh.ru/employer/4168187
|
|
276
|
+
https://hh.ru/employer/9274777
|
|
277
|
+
https://hh.ru/employer/1763330
|
|
278
|
+
https://hh.ru/employer/5926815
|
|
279
|
+
https://hh.ru/employer/1592535
|
|
280
|
+
https://hh.ru/employer/9627641
|
|
281
|
+
https://hh.ru/employer/4073857
|
|
282
|
+
https://hh.ru/employer/2667859
|
|
283
|
+
https://hh.ru/employer/4053700
|
|
284
|
+
https://hh.ru/employer/5190600
|
|
285
|
+
https://hh.ru/employer/607484
|
|
286
|
+
https://hh.ru/employer/9386615
|
|
287
|
+
https://hh.ru/employer/80660
|
|
288
|
+
https://hh.ru/employer/6078902
|
|
289
|
+
https://hh.ru/employer/1918903
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
Данная возможность полезна для написания Bash-скриптов.
|
|
293
|
+
|
|
294
|
+
Глобальные флаги:
|
|
295
|
+
|
|
296
|
+
- `-v` используется для вывода отладочной информации. Два таких флага, например, выводят запросы к **API**.
|
|
297
|
+
- `-c <path>` можно создать путь до конфига. С помощью этого флага можно одновременно использовать несколько профилей.
|
|
298
|
+
|
|
299
|
+
| Операция | Описание |
|
|
300
|
+
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
301
|
+
| **authorize** | Открывает сайт hh.ru для авторизации и перехватывает перенаправление на `hhadnroid://oauthresponse` |
|
|
302
|
+
| **whoami** | Выводит информацию об авторизованном пользователе |
|
|
303
|
+
| **list-resumes** | Список резюме |
|
|
304
|
+
| **update-resumes** | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату». |
|
|
305
|
+
| **apply-similar** | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан. |
|
|
306
|
+
| **reply-employers** | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ |
|
|
307
|
+
| **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят |
|
|
308
|
+
| **call-api** | Вызов произвольного метода API с выводом результата. |
|
|
309
|
+
| **refresh-token** | Обновляет access_token. |
|
|
310
|
+
| **config** | Редактировать конфигурационный файл. |
|
|
311
|
+
| **get-employer-contacts** | Получить список полученных вами контактов работодателей. Поддерживается так же экспорт в html/jsonl. Если хотите собирать контакты с нескольких акков, то укажите им одинаковый `client_telemetry_id` в конфигах. |
|
|
312
|
+
| **delete-telemetry** | Удадяет телеметрию (контакты работодателей, которые вас пригласили), если та была включена. |
|
|
313
|
+
|
|
314
|
+
Данные имена команд равнозначны: `call-api = callApi = callapi`. Можно использовать `kebab-case`, `camelCase` и `flatcase`.
|
|
315
|
+
|
|
316
|
+
### Формат текста сообщений
|
|
317
|
+
|
|
318
|
+
Команда `apply-similar` поддерживает специальный формат сообщений.
|
|
319
|
+
|
|
320
|
+
Так же в сообщении можно использовать плейсхолдеры:
|
|
321
|
+
|
|
322
|
+
- **`%(vacancy_name)s`**: Название вакансии.
|
|
323
|
+
- **`%(employer_name)s`**: Название работодателя.
|
|
324
|
+
- **`%(first_name)s`**: Имя пользователя.
|
|
325
|
+
- **`%(last_name)s`**: Фамилия пользователя.
|
|
326
|
+
- **`%(email)s`**: Email пользователя.
|
|
327
|
+
- **`%(phone)s`**: Телефон пользователя.
|
|
328
|
+
|
|
329
|
+
Эти плейсхолдеры могут быть использованы в сообщениях для отклика на вакансии, чтобы динамически подставлять соответствующие данные в текст сообщения. Например:
|
|
330
|
+
|
|
331
|
+
```
|
|
332
|
+
Меня заинтересовала ваша вакансия %(vacancy_name)s. Прошу рассмотреть мою кандидатуру. С уважением, %(first_name)s %(last_name)s.
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
Так же можно делать текст уникальным с помощью `{}`. Внутри них через `|` перечисляются варианты, один из которых будет случайно выбран:
|
|
336
|
+
|
|
337
|
+
```
|
|
338
|
+
{Здоров|Привет}, {как {ты|сам}|что делаешь}?
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
В итоге получится что-то типа:
|
|
342
|
+
|
|
343
|
+
```
|
|
344
|
+
Привет, как ты?
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
### Использование AI для генерации сопроводительного письма
|
|
348
|
+
|
|
349
|
+
Пример рассылки откликов с генерированным письмом:
|
|
350
|
+
|
|
351
|
+
```sh
|
|
352
|
+
hh-applicant-tool apply-similar -f --ai
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
#### OpenAI/ChatGPT
|
|
356
|
+
|
|
357
|
+
Отредактируйте конфиг:
|
|
358
|
+
|
|
359
|
+
```json
|
|
360
|
+
{
|
|
361
|
+
// ...
|
|
362
|
+
"openai": {
|
|
363
|
+
"token": "ВАШ_API_КЛЮЧ_OPENAI",
|
|
364
|
+
"model": "gpt-4o",
|
|
365
|
+
"system_prompt": "Вы опытный HR-специалист. Напишите идеальное сопроводительное письмо..."
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
```
|
|
369
|
+
|
|
370
|
+
#### Эксперементальная поддержка BlackBox
|
|
371
|
+
|
|
372
|
+
> Поддержка Blackbox будет удалена.
|
|
373
|
+
|
|
374
|
+
- Перейдите на сайт [blackbox.ai](https://www.blackbox.ai) и создайте чат.
|
|
375
|
+
- В первом сообщении опишите свой опыт и тп.
|
|
376
|
+
- Далее откройте devtools, нажав `F12`.
|
|
377
|
+
- Во вкладке `Network` последним должен быть POST-запрос на `https://www.blackbox.ai/api/chat`.
|
|
378
|
+
- Запустите редактирование конфига:
|
|
379
|
+
```sh
|
|
380
|
+
hh-applicant-tool config
|
|
381
|
+
```
|
|
382
|
+
- Измените конфиг:
|
|
383
|
+
```json
|
|
384
|
+
{
|
|
385
|
+
// ...
|
|
386
|
+
"blackbox": {
|
|
387
|
+
"session_id": "<В заголовках запроса найдите Cookie, скопируйте сюда значение sessionId до ;>",
|
|
388
|
+
"chat_payload": <Сюда вставьте тело запроса типа {"messages":[{"id":"IXqdOx9","content":"Я программист fullstack-разработчик...","role":"user"}],"id":"IXqdOx9","previewToken":null,"userId":null,...,"webSearchModePrompt":false,"deepSearchMode":false}>
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
```
|
|
392
|
+
|
|
393
|
+
### Работа с API напрямую
|
|
394
|
+
|
|
395
|
+
Документация для работы с API соискателей была удалена с ха-ха и его копропротивного репозитория. Можете не искать, они затерли даже историю репозитория. Но я через веб-архив выкачал документацию. Чтобы ее посмотреть, клонируйте этот репозиторий и выполните:
|
|
396
|
+
|
|
397
|
+
```sh
|
|
398
|
+
npx @redocly/cli preview -d docs/hhapi
|
|
399
|
+
```
|
|
400
|
+
|
|
401
|
+
Далее нужно в браузере открыть [http://localhost:4000](http://localhost:4000).
|
|
402
|
+
|
|
403
|
+
<img width="2560" height="1440" alt="image" src="https://github.com/user-attachments/assets/a963b405-b872-4865-abed-fd704532cd80" />
|
|
404
|
+
|
|
405
|
+
> Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
|
|
406
|
+
|
|
407
|
+
Для тестирования запросов к API используйте команду `call-api` и `jq` для вывода JSON в удобочитаемом формате. По-сути, никакие дополнительные команды кроме имеющихся не нужны. Вы можете сделать что угодно с помощью `call-api`.
|
|
408
|
+
|
|
409
|
+
Синтаксис `call-api` немного похож на `httpie` или `curlie`:
|
|
410
|
+
|
|
411
|
+
```sh
|
|
412
|
+
hh-applicant-tool call-api [ -m {GET|POST|PUT|DELETE} ] /path/to/endpoint [ key1=value1 [ ... keyN=valueN ] ]
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
Если используется метод `GET` или `DELETE` (или ничего не указано), то параметры будут переданы как query string. Во всех остальных случаях парметры передаются как `application/x-www-form-urlencoded` в теле запроса.
|
|
416
|
+
|
|
417
|
+
Пример блокировки контактов мошенников:
|
|
418
|
+
|
|
419
|
+
```sh
|
|
420
|
+
# Делаем дамп ваших контактов
|
|
421
|
+
hh-applicant-tool get-employer-contacts --export -f jsonl > contacts.dump
|
|
422
|
+
|
|
423
|
+
# Теперь блокируем всех мошенников
|
|
424
|
+
jq -r 'select(.is_scam == true) | .employer.id' contacts.dump | sort -u | xargs -I {} hh-applicant-tool call-api -m PUT /employers/blacklisted/{}
|
|
425
|
+
|
|
426
|
+
# И императивная версия
|
|
427
|
+
for id in $(jq -r 'select(.is_scam == true) | .employer.id' contacts.dump | sort -u); do
|
|
428
|
+
hh-applicant-tool call-api -m PUT "/employers/blacklisted/$id"
|
|
429
|
+
done
|
|
430
|
+
```
|
|
431
|
+
|
|
432
|
+
### Добавление своих команд
|
|
433
|
+
|
|
434
|
+
Утилита использует систему плагинов. Все они лежат в [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).
|
|
435
|
+
|
|
436
|
+
|