hh-applicant-tool 0.3.6__py3-none-any.whl → 0.3.8__py3-none-any.whl

hh_applicant_tool/api/client.py

@@ -37,6 +37,7 @@ class BaseClient:
     _: dataclasses.KW_ONLY
     # TODO: сделать генерацию User-Agent'а как в приложении
     user_agent: str | None = None
+    proxies: dict | None = None
     session: Session | None = None
     previous_request_time: float = 0.0
     delay: float = 0.334
@@ -47,8 +48,8 @@ class BaseClient:
             self.session = session = requests.session()
             session.headers.update(
                 {
-                    **self.additional_headers(),
                     "User-Agent": self.user_agent or self.default_user_agent(),
+                    **self.additional_headers(),
                 }
             )
             logger.debug("Default Headers: %r", session.headers)
@@ -101,10 +102,13 @@ class BaseClient:
                 logger.debug("wait %fs before request", delay)
                 time.sleep(delay)
             has_body = method in ["POST", "PUT"]
+            user_agent = self.user_agent or self.default_user_agent()
+            logger.debug(f"{user_agent = }")
             response = self.session.request(
                 method,
                 url,
                 **{"data" if has_body else "params": params},
+                proxies=self.proxies,
                 allow_redirects=False,
             )
             try:

hh_applicant_tool/main.py

@@ -5,13 +5,13 @@ import logging
 import sys
 from abc import ABCMeta, abstractmethod
 from importlib import import_module
-from os import getenv
 from pathlib import Path
 from pkgutil import iter_modules
-from typing import Sequence
+from typing import Sequence, Literal
 from .api import ApiClient
 from .color_log import ColorHandler
 from .utils import Config, get_config_path
+from os import getenv
 
 DEFAULT_CONFIG_PATH = (
     get_config_path() / __package__.replace("_", "-") / "config.json"
@@ -34,6 +34,15 @@ class Namespace(argparse.Namespace):
     config: Config
     verbosity: int
     delay: float
+    user_agent: str
+    proxy_url: str
+
+
+def get_proxies(args: Namespace) -> dict[Literal["http", "https"], str | None]:
+    return {
+        "http": args.config["proxy_url"] or getenv("HTTP_PROXY"),
+        "https": args.config["proxy_url"] or getenv("HTTPS_PROXY"),
+    }
 
 
 def get_api(args: Namespace) -> ApiClient:
@@ -41,8 +50,9 @@ def get_api(args: Namespace) -> ApiClient:
     api = ApiClient(
         access_token=token.get("access_token"),
         refresh_token=token.get("refresh_token"),
-        user_agent=args.config["user_agent"],
         delay=args.delay,
+        user_agent=args.config["user_agent"],
+        proxies=get_proxies(args),
     )
     return api
 
@@ -87,6 +97,12 @@ class HHApplicantTool:
             default=0.334,
             help="Задержка между запросами к API HH",
         )
+        parser.add_argument(
+            "--user-agent", help="User-Agent для каждого запроса"
+        )
+        parser.add_argument(
+            "--proxy-url", help="Прокси, используемый для запросов к API"
+        )
         subparsers = parser.add_subparsers(help="commands")
         package_dir = Path(__file__).resolve().parent / OPERATIONS
         for _, module_name, _ in iter_modules([str(package_dir)]):
@@ -94,7 +110,8 @@ class HHApplicantTool:
             op: BaseOperation = mod.Operation()
             op_parser = subparsers.add_parser(
                 module_name.replace("_", "-"),
-                description=op.__doc__, formatter_class=self.ArgumentFormatter
+                description=op.__doc__,
+                formatter_class=self.ArgumentFormatter,
             )
             op_parser.set_defaults(run=op.run)
             op.setup_parser(op_parser)

hh_applicant_tool/operations/apply_similar.py

@@ -9,10 +9,10 @@ from typing import TextIO, Tuple
 from ..api import ApiClient, ApiError, BadRequest
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace, get_api
-from ..telemetry_client import TelemetryError
-from ..telemetry_client import get_client as get_telemetry_client
+from ..telemetry_client import TelemetryClient, TelemetryError
 from ..types import ApiListResponse, VacancyItem
-from ..utils import fix_datetime, print_err, truncate_string
+from ..utils import fix_datetime, truncate_string, random_text
+from requests import Session
 
 logger = logging.getLogger(__package__)
 
@@ -23,8 +23,13 @@ class Namespace(BaseNamespace):
     force_message: bool
     apply_interval: Tuple[float, float]
     page_interval: Tuple[float, float]
+    message_interval: Tuple[float, float]
+    order_by: str
+    search: str
+    reply_message: str
 
 
+# gx для открытия (никак не запомню в виме)
 # https://api.hh.ru/openapi/redoc
 class Operation(BaseOperation):
     """Откликнуться на все подходящие вакансии. По умолчанию применяются значения, которые были отмечены галочками в форме для поиска на сайте"""
@@ -33,7 +38,7 @@ class Operation(BaseOperation):
         parser.add_argument("--resume-id", help="Идентефикатор резюме")
         parser.add_argument(
             "--message-list",
-            help="Путь до файла, где хранятся сообщения для отклика на вакансии. Каждое сообщение — с новой строки. В сообщения можно использовать плейсхолдеры типа %%(name)s",
+            help="Путь до файла, где хранятся сообщения для отклика на вакансии. Каждое сообщение — с новой строки. В сообщения можно использовать плейсхолдеры типа %%(vacabcy_name)s",
             type=argparse.FileType(),
         )
         parser.add_argument(
@@ -44,16 +49,22 @@ class Operation(BaseOperation):
         )
         parser.add_argument(
             "--apply-interval",
-            help="Интервал между отправкой откликов в секундах (X, X-Y)",
+            help="Интервал перед отправкой откликов в секундах (X, X-Y)",
             default="1-5",
             type=self._parse_interval,
         )
         parser.add_argument(
             "--page-interval",
-            help="Интервал между получением следующей страницы рекомендованных вакансий в секундах (X, X-Y)",
+            help="Интервал перед получением следующей страницы рекомендованных вакансий в секундах (X, X-Y)",
             default="1-3",
             type=self._parse_interval,
         )
+        parser.add_argument(
+            "--message-interval",
+            help="Интервал перед отправкой сообщения в секундах (X, X-Y)",
+            default="5-10",
+            type=self._parse_interval,
+        )
         parser.add_argument(
             "--order-by",
             help="Сортировка вакансий",
@@ -68,10 +79,15 @@ class Operation(BaseOperation):
         )
         parser.add_argument(
             "--search",
-            help="Строка поиска для фильтрации вакансий, например, 'москва бухгалтер 100500', те можно и город указать, и ожидаемую зряплату",
+            help="Строка поиска для фильтрации вакансий, например, 'москва бухгалтер 100500', те можно и город указать, и ожидаемую зарплату",
             type=str,
             default=None,
         )
+        parser.add_argument(
+            "--reply-message",
+            "--reply",
+            help="Отправить сообщение во все чаты, где ожидают ответа либо не прочитали ответ",
+        )
 
     @staticmethod
     def _parse_interval(interval: str) -> Tuple[float, float]:
@@ -89,6 +105,7 @@ class Operation(BaseOperation):
 
         apply_min_interval, apply_max_interval = args.apply_interval
         page_min_interval, page_max_interval = args.page_interval
+        message_min_interval, message_max_interval = args.message_interval
 
         self._apply_similar(
             api,
@@ -99,8 +116,11 @@ class Operation(BaseOperation):
             apply_max_interval,
             page_min_interval,
             page_max_interval,
+            message_min_interval,
+            message_max_interval,
             args.order_by,
             args.search,
+            args.reply_message or args.config["reply_message"],
         )
 
     def _get_resume_id(self, args: Namespace, api: ApiClient) -> str:
@@ -118,11 +138,8 @@ class Operation(BaseOperation):
             )
         else:
             application_messages = [
-                "Меня заинтересовала ваша вакансия %(name)s",
-                "Прошу рассмотреть мою жалкую кандидатуру на вакансию %(name)s",
-                "Ваша вакансия %(name)s соответствует моим навыкам и опыту",
-                "Хочу присоединиться к вашей успешной команде лидеров рынка в качестве %(name)s",
-                "Мое резюме содержит все баззворды, указанные в вашей вакансии %(name)s",
+                "{Меня заинтересовала|Мне понравилась} ваша вакансия %(vacancy_name)s",
+                "{Прошу рассмотреть|Предлагаю рассмотреть} {мою кандидатуру|мое резюме} на вакансию %(vacancy_name)s",
             ]
         return application_messages
 
@@ -136,10 +153,17 @@ class Operation(BaseOperation):
         apply_max_interval: float,
         page_min_interval: float,
         page_max_interval: float,
+        message_min_interval: float,
+        message_max_interval: float,
         order_by: str,
         search: str | None = None,
+        reply_message: str | None = None,
     ) -> None:
-        telemetry_client = get_telemetry_client()
+        # TODO: вынести куда-нибудь в функцию
+        session = Session()
+        session.headers["User-Agent"] = "Mozilla/5.0 (HHApplicantTelemetry/1.0)"
+        session.proxies = dict(api.session.proxies)
+        telemetry_client = TelemetryClient(session=session)
         telemetry_data = defaultdict(dict)
 
         vacancies = self._get_vacancies(
@@ -154,33 +178,124 @@ class Operation(BaseOperation):
 
         self._collect_vacancy_telemetry(telemetry_data, vacancies)
 
+        me = api.get("/me")
+
+        basic_message_placeholders = {
+            "first_name": me.get("first_name", ""),
+            "last_name": me.get("last_name", ""),
+            "email": me.get("email", ""),
+            "phone": me.get("phone", ""),
+        }
+
+        do_apply = True
+
         for vacancy in vacancies:
             try:
                 if getenv("TEST_TELEMETRY"):
                     break
 
+                message_placeholders = {
+                    "vacancy_name": vacancy.get("name", ""),
+                    "employer_name": vacancy.get("employer", {}).get(
+                        "name", ""
+                    ),
+                    **basic_message_placeholders,
+                }
+
+                logger.debug(
+                    "Вакансия %(vacancy_name)s от %(employer_name)s"
+                    % message_placeholders
+                )
+
                 if vacancy.get("has_test"):
                     print("🚫 Пропускаем тест", vacancy["alternate_url"])
                     continue
 
+                if vacancy.get("archived"):
+                    print(
+                        "🚫 Пропускаем вакансию в архиве",
+                        vacancy["alternate_url"],
+                    )
+
+                    continue
+
                 relations = vacancy.get("relations", [])
 
                 if relations:
+                    if "got_rejection" in relations:
+                        print(
+                            "🚫 Пропускаем отказ на вакансию",
+                            vacancy["alternate_url"],
+                        )
+                        continue
+
+                    if reply_message:
+                        r = api.get("/negotiations", vacancy_id=vacancy["id"])
+
+                        if len(r["items"]) == 1:
+                            neg = r["items"][0]
+                            nid = neg["id"]
+
+                            page: int = 0
+                            last_message: dict | None = None
+                            while True:
+                                r2 = api.get(
+                                    f"/negotiations/{nid}/messages", page=page
+                                )
+                                last_message = r2["items"][-1]
+                                if page + 1 >= r2["pages"]:
+                                    break
+
+                                page = r2["pages"] - 1
+
+                            logger.debug(last_message["text"])
+
+                            if last_message["author"][
+                                "participant_type"
+                            ] == "employer" or not neg.get(
+                                "viewed_by_opponent"
+                            ):
+                                message = (
+                                    random_text(reply_message)
+                                    % message_placeholders
+                                )
+                                logger.debug(message)
+
+                                time.sleep(
+                                    random.uniform(
+                                        message_min_interval,
+                                        message_max_interval,
+                                    )
+                                )
+                                api.post(
+                                    f"/negotiations/{nid}/messages",
+                                    message=message,
+                                )
+                                print(
+                                    "📨 Отправили сообщение для привлечения внимания",
+                                    vacancy["alternate_url"],
+                                )
+                            continue
+                        else:
+                            logger.warning(
+                                "Приглашение без чата для вакансии: %s",
+                                vacancy["alternate_url"],
+                            )
+
                     print(
-                        "🚫 Пропускаем ответ на заявку",
+                        "🚫 Пропускаем вакансию с откликом",
                         vacancy["alternate_url"],
                     )
                     continue
 
-                try:
-                    employer_id = vacancy["employer"]["id"]
-                except KeyError:
-                    logger.warning(
-                        f"Вакансия без работодателя: {vacancy['alternate_url']}"
-                    )
-                else:
-                    employer = api.get(f"/employers/{employer_id}")
+                employer_id = vacancy.get("employer", {}).get("id")
 
+                if (
+                    employer_id
+                    and employer_id not in telemetry_data["employers"]
+                    and 200 > len(telemetry_data["employers"])
+                ):
+                    employer = api.get(f"/employers/{employer_id}")
                     telemetry_data["employers"][employer_id] = {
                         "name": employer.get("name"),
                         "type": employer.get("type"),
@@ -189,11 +304,9 @@ class Operation(BaseOperation):
                         "area": employer.get("area", {}).get("name"),  # город
                     }
 
-                # Задержка перед отправкой отклика
-                interval = random.uniform(
-                    apply_min_interval, apply_max_interval
-                )
-                time.sleep(interval)
+                if not do_apply:
+                    logger.debug("skip apply similar")
+                    continue
 
                 params = {
                     "resume_id": resume_id,
@@ -201,19 +314,23 @@ class Operation(BaseOperation):
                     "message": "",
                 }
 
-                if vacancy.get("response_letter_required"):
-                    message_template = random.choice(application_messages)
-
-                    try:
-                        params["message"] = message_template % vacancy
-                    except TypeError as ex:
-                        # TypeError: not enough arguments for format string
-                        # API HH все кривое, иногда нет идентификатора работодателя, иногда у вакансии нет названия.
-                        # И это типа рашн хайлоад, где из-за дрочки на аджайл слепили кривую говнину.
-                        logger.error(
-                            f"Ошибка форматирования шаблона сообщения {template_message!r} для {vacancy = }"
-                        )
-                        continue
+                if force_message or vacancy.get("response_letter_required"):
+                    msg = params["message"] = (
+                        random_text(random.choice(application_messages))
+                        % message_placeholders
+                    )
+                    logger.debug(msg)
+
+                # Задержка перед отправкой отклика
+                interval = random.uniform(
+                    max(apply_min_interval, message_min_interval)
+                    if params["message"]
+                    else apply_min_interval,
+                    max(apply_max_interval, message_max_interval)
+                    if params["message"]
+                    else apply_max_interval,
+                )
+                time.sleep(interval)
 
                 res = api.post("/negotiations", params)
                 assert res == {}
@@ -225,12 +342,15 @@ class Operation(BaseOperation):
                     ")",
                 )
             except ApiError as ex:
-                print_err("❗ Ошибка:", ex)
+                logger.error(ex)
                 if isinstance(ex, BadRequest) and ex.limit_exceeded:
-                    break
+                    if not reply_message:
+                        break
+                    do_apply = False
 
         print("📝 Отклики на вакансии разосланы!")
 
+        # Я собираюсь выложить контакты херок в общественный доступ
         self._send_telemetry(telemetry_client, telemetry_data)
 
     def _get_vacancies(

hh_applicant_tool/telemetry_client.py

@@ -3,7 +3,6 @@ import json
 from urllib.parse import urljoin
 import requests
 from typing import Optional, Dict, Any
-from functools import cache
 import logging
 import base64
 
@@ -64,8 +63,3 @@ class TelemetryClient:
             json.JSONDecodeError,
         ) as ex:
             raise TelemetryError(str(ex)) from ex
-
-
-@cache
-def get_client() -> TelemetryClient:
-    return TelemetryClient()

hh_applicant_tool/utils.py

@@ -10,6 +10,8 @@ from threading import Lock
 from typing import Any
 from os import getenv
 from .constants import INVALID_ISO8601_FORMAT
+import re
+import random
 
 print_err = partial(print, file=sys.stderr, flush=True)
 
@@ -72,3 +74,17 @@ def fix_datetime(dt: str | None) -> str | None:
     if dt is None:
         return None
     return datetime.strptime(dt, INVALID_ISO8601_FORMAT).isoformat()
+
+
+def random_text(s: str) -> str:
+    while (
+        s1 := re.sub(
+            r"{([^{}]+)}",
+            lambda m: random.choice(
+                m.group(1).split("|"),
+            ),
+            s,
+        )
+    ) != s:
+        s = s1
+    return s

{hh_applicant_tool-0.3.6.dist-info → hh_applicant_tool-0.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.3.6
+Version: 0.3.8
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -14,7 +14,7 @@ Provides-Extra: qt
 Requires-Dist: prettytable (>=3.6.0,<4.0.0)
 Requires-Dist: pyqt6 (>=6.7.1,<7.0.0) ; extra == "qt"
 Requires-Dist: pyqt6-webengine (>=6.7.0,<7.0.0) ; extra == "qt"
-Requires-Dist: requests (>=2.28.2,<3.0.0)
+Requires-Dist: requests[socks] (>=2.32.3,<3.0.0)
 Description-Content-Type: text/markdown
 
 ## HH Applicant Tool
@@ -30,19 +30,21 @@ Description-Content-Type: text/markdown
   <img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
 </div>
 
+### Описание
+
 Утилита для успешных волчат, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме. Поддержка осуществляется строго в группе https://t.me/+aSjr8qM_AP85ZDBi (в ней разрешены мат, п*рнография, оскорбления всех участников кроме админа, а так же слив любой информации про хуевых работодателей и нерадивых херок).
 
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще...
 
-Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести `~/.config/hh-applicant-tool/config.json` (`C:\Users\%username%\AppData\Roaming\hh-applicant-tool\config.json` — в Windows) на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
+Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести конфиг на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
 
 Пример работы:
 
 ![image](https://github.com/user-attachments/assets/55ab24ba-5325-40b4-9bd9-69ebcbc011c4)
 
 
-Предыстория.
+### Предыстория
 
 Был один знакомый знакомого, который работал хрюшей. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отличить Java от JavaScript, но я думаю, что <s>в значительном числе случаев, тут имеют место такие вот рассылки</s> они просто идиотки... И я тупо стал спамить как они. Мне уже было просто лень читать весь этот бред, что пишут долбоебы в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое.
 
@@ -54,7 +56,7 @@ $$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
 
 Оно работает, хоть и не идеально. Я даже пробовал автоматизировать рассылки через `p[yu]ppeeter`, пока не прочитал [документацию](https://github.com/hhru/api). И не обнаружил, что **API** (интерфейс) содержит все необходимые мне методы. Headhunter позволяет создать свое приложение, но там ручная модерация, и наврядли кто-то разрешит мне создать приложение для спама заявками. Я [декомпилировал](https://gist.github.com/s3rgeym/eee96bbf91b04f7eb46b7449f8884a00) официальное приложение для **Android** и получил **CLIENT_ID** и **CLIENT_SECRET**, необходимые для работы через **API**.
 
-Установка:
+### Установка
 
 ```bash
 # Версия с поддержкой авторизации через запуск окна с браузером (эта версия очень много весит)
@@ -91,9 +93,89 @@ $ pipx upgrade hh-applicant-tool
   ```
 * В случае неудачи вернитесь к первому шагу.
 * Для последующих запусков сначала активируйте виртуальное окружение.
-  
 
-Использование:
+### Авторизация
+
+```bash
+$ hh-applicant-tool -vv authorize
+```
+
+![image](https://github.com/user-attachments/assets/88961e31-4ea3-478f-8c43-914d6785bc3b)
+
+> В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
+
+Проверка авторизации:
+
+```bash
+$ hh-applicant-tool whoami
+{
+  "auth_type": "applicant",
+  "counters": {
+    "new_resume_views": 1488,
+    "resumes_count": 1,
+    "unread_negotiations": 228
+  },
+  "email": "vasya.pupkin@gmail.com",
+  "employer": null,
+  "first_name": "Вася",
+  "id": "1234567890",
+  "is_admin": false,
+  "is_anonymous": false,
+  "is_applicant": true,
+  "is_application": false,
+  "is_employer": false,
+  "is_in_search": true,
+  "last_name": "Пупкин",
+  "manager": null,
+  "mid_name": null,
+  "middle_name": null,
+  "negotiations_url": "https://api.hh.ru/negotiations",
+  "personal_manager": null,
+  "phone": "79012345678",
+  "profile_videos": {
+    "items": []
+  },
+  "resumes_url": "https://api.hh.ru/resumes/mine"
+}
+```
+
+В случае успешной авторизации токены будут сохранены в `config.json`:
+
+```json
+{
+  "token": {
+    "access_token": "...",
+    "created_at": 1678151427,
+    "expires_in": 1209599,
+    "refresh_token": "...",
+    "token_type": "bearer"
+  }
+}
+```
+
+Токен доступа выдается на две недели. После его нужно обновить:
+
+```bash
+$ hh-applicant-tool refresh-token
+```
+
+### Пути до файла config.json
+
+| OS                         | Путь                                                                |
+|----------------------------|---------------------------------------------------------------------|
+| **Windows**                | `C:\Users\%username%\AppData\Roaming\hh-applicant-tool\config.json` |
+| **macOS**                  | `~/Library/Application Support/hh-applicant-tool/config.json`       |
+| **Linux**                  | `~/.config/hh-applicant-tool/config.json`                           |
+
+
+Через конфиг можно задать дополнительные настройки:
+
+| Имя атрибута | Описание |
+| `user_agent` | Кастомный юзерагент, передаваемый при кажом запросе, например, `Mozilla/5.0 YablanBrowser` |
+| `proxy_url` | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050` |
+| `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений |
+
+### Описание команд
 
 ```bash
 $ hh-applicant-tool [ GLOBAL_FLAGS ] [ OPERATION [ OPERATION_FLAGS  ] ]
@@ -160,107 +242,47 @@ https://hh.ru/employer/1918903
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
-| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Контакты получаются строго из публичного доступа, например, сайта фирмы и могут быть удалены по просьбе упал_намоченный лицо. Данная функция готова и будет доступна после 100 ⭐  |
+| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Контакты получаются строго из публичного доступа, например, с сайта фирмы и могут быть удалены только по просьбе уполнамоченного лица. Данная функция готова и будет доступна после 100 ⭐  |
 
-Авторизуемся:
+### Формат текста сообщений
 
-```bash
-$ hh-applicant-tool -vv authorize
-```
-
-![image](https://github.com/user-attachments/assets/88961e31-4ea3-478f-8c43-914d6785bc3b)
-
-> В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
+Команда `apply-similar` поддерживает специальный формат сообщений.
 
+Так же в сообщении можно использовать плейсхолдеры:
 
+- **`%(vacancy_name)s`**: Название вакансии.
+- **`%(employer_name)s`**: Название работодателя.
+- **`%(first_name)s`**: Имя пользователя.
+- **`%(last_name)s`**: Фамилия пользователя.
+- **`%(email)s`**: Email пользователя.
+- **`%(phone)s`**: Телефон пользователя.
 
-В случае успешной авторизации токены будут сохранены в `~/.config/hh-applicant-tool/config.json`:
+Эти плейсхолдеры могут быть использованы в сообщениях для отклика на вакансии, чтобы динамически подставлять соответствующие данные в текст сообщения. Например:
 
-```json
-{
-  "token": {
-    "access_token": "...",
-    "created_at": 1678151427,
-    "expires_in": 1209599,
-    "refresh_token": "...",
-    "token_type": "bearer"
-  }
-}
 ```
-
-Через этот файл можно задать кастомный `user_agent`:
-
-```json
-{
-  "user_agent": "Mozilla/5.0 (X11; Linux x86_64; rv:109.0) Gecko/20100101 Firefox/110.0"
-}
+Меня заинтересовала ваша вакансия %(vacancy_name)s. Прошу рассмотреть мою кандидатуру. С уважением, %(first_name)s %(last_name)s.
 ```
 
-Проверка авторизации:
+Так же можно делать текст уникальным с помощью `{}`. Внутри них через `|` перечисляются варианты, один из которых будет случайно выбран:
 
-```bash
-$ hh-applicant-tool whoami
-{
-  "auth_type": "applicant",
-  "counters": {
-    "new_resume_views": 1488,
-    "resumes_count": 1,
-    "unread_negotiations": 228
-  },
-  "email": "vasya.pupkin@gmail.com",
-  "employer": null,
-  "first_name": "Вася",
-  "id": "1234567890",
-  "is_admin": false,
-  "is_anonymous": false,
-  "is_applicant": true,
-  "is_application": false,
-  "is_employer": false,
-  "is_in_search": true,
-  "last_name": "Пупкин",
-  "manager": null,
-  "mid_name": null,
-  "middle_name": null,
-  "negotiations_url": "https://api.hh.ru/negotiations",
-  "personal_manager": null,
-  "phone": "79012345678",
-  "profile_videos": {
-    "items": []
-  },
-  "resumes_url": "https://api.hh.ru/resumes/mine"
-}
 ```
-
-Токен выдается на две недели:
-
-```python
-Python 3.10.9 (main, Dec 19 2022, 17:35:49) [GCC 12.2.0] on linux
-Type "help", "copyright", "credits" or "license" for more information.
->>> from datetime import datetime, timedelta
->>> datetime.now() + timedelta(seconds=1209599)
-datetime.datetime(2023, 3, 23, 6, 36, 15, 596290)
->>>
+{Здоров|Привет}, {как {ты|сам}|что делаешь}?
 ```
 
-После нужно вызвать `refresh-token`:
+В итоге получится что-то типа:
 
-```bash
-$ hh-applicant-tool refresh-token
 ```
-
-Удаление хвостов:
-
-```bash
-rm -rf ~/.config/hh-applicant-tool
-
-# В старых версиях добавлялся обработчик протокола через socat
-rm -f ~/.local/share/applications/hhandroid.desktop
+Привет, как ты?
 ```
 
+### Написание плагинов
+
 Утилита использует систему плагинов. Все они лежат в [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).
 
 Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
 
+### Сбор данных
+
 Утилита собирает и передает на сервер разработчика следующую информацию:
 
 1. Название вакансии.
@@ -270,7 +292,7 @@ rm -f ~/.local/share/applications/hhandroid.desktop
 1. Прямая ссылка на вакансию.
 1. Дата создания вакансии.
 1. Дата публикации вакансии.
-1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, хранящаеся в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля (может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и росписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова).
+1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, которая в дальнейшем _может_ храниться в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля. Данная информация может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и подписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова.
 1. Название компании.
 1. Тип компании.
 1. Описание компании.

{hh_applicant_tool-0.3.6.dist-info → hh_applicant_tool-0.3.8.dist-info}/RECORD

@@ -1,13 +1,13 @@
 hh_applicant_tool/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hh_applicant_tool/__main__.py,sha256=cwKJAAML0RRKT9Qbzcwf07HHcuSd8oh7kx4P1apndWQ,84
 hh_applicant_tool/api/__init__.py,sha256=kgFSHibRaAugN2BA3U1djEa20qgKJUUVouwJzjEB0DU,84
-hh_applicant_tool/api/client.py,sha256=c0XBEQIS-kPi2JeS9TmgcO8ZyOjV6HsgiwZRcKUOQCI,7927
+hh_applicant_tool/api/client.py,sha256=o_9hDdtCH3xHgBKwqoriNy0wncgUANDR8y--ZxVPQGM,8112
 hh_applicant_tool/api/errors.py,sha256=0SoWKnsSUA0K2YgQA8GwGhe-pRMwtfK94MR6_MgbORQ,1722
 hh_applicant_tool/color_log.py,sha256=gN6j1Ayy1G7qOMI_e3WvfYw_ublzeQbKgsVLhqGg_3s,823
 hh_applicant_tool/constants.py,sha256=lpgKkP2chWgTnBXvzxbSPWpKcfzp8VxMTlkssFcQhH4,469
-hh_applicant_tool/main.py,sha256=sL9eSWUkOz-NJbkq8PxRluvXUh5AqLVi7qmrdN1YAKY,3996
+hh_applicant_tool/main.py,sha256=B_kI9MlaT_064r5CL7Pjlzu76QPB-hXCaMpFtB-BOfg,4596
 hh_applicant_tool/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hh_applicant_tool/operations/apply_similar.py,sha256=fNiQlxjdRzaG2w-mWhZoaCo8OyAp71NM3PJamyTGyi8,12726
+hh_applicant_tool/operations/apply_similar.py,sha256=9dPvO_3o9rGgaUKxEChgc1cL69YpXuJY8tpP_4iD6TY,17249
 hh_applicant_tool/operations/authorize.py,sha256=TyUTCSOGwSYVJMEd5vSI981LRRI-RZf8hnlVYhtRVwA,3184
 hh_applicant_tool/operations/call_api.py,sha256=qwPDrWP9tiqHkaYYWYBZtymj9AaxObB86Eny-Bf5q_c,1314
 hh_applicant_tool/operations/clear_negotiations.py,sha256=98Yuw9xP4dN5sUnUKlZxqfhU40TQ-aCjK4vj4LRTeYo,3894
@@ -15,10 +15,10 @@ hh_applicant_tool/operations/list_resumes.py,sha256=XBrVFTnl45BUtuvjVm70h_CXZrOv
 hh_applicant_tool/operations/refresh_token.py,sha256=hYTmzBzJFSsb-LDO2_w0Y30WVWsctIH7vTzirkLwzWo,1267
 hh_applicant_tool/operations/update_resumes.py,sha256=gGxMYMoT9GqJjwn4AgrOAEJCZu4sdhaV0VmPr3jG-q8,1049
 hh_applicant_tool/operations/whoami.py,sha256=sg0r7m6oKkpMEmGt4QdtYdS-1gf-1KKdnk32yblbRJs,714
-hh_applicant_tool/telemetry_client.py,sha256=1jgbc8oMfLhbEi2pTA2fF0pKlHSWekHY3oEJCDI8Uas,2268
+hh_applicant_tool/telemetry_client.py,sha256=8R5cdB8971j1rz0v0nhh1TBbqHHD9LYdBUnd5sh-kik,2165
 hh_applicant_tool/types.py,sha256=q3yaIcq-UOkPzjxws0OFa4w9fTty-yx79_dic70_dUM,843
-hh_applicant_tool/utils.py,sha256=wXcxs5IinK7PH6ipCCpngw7faUiboEpi9a8j1wDEPKw,2282
-hh_applicant_tool-0.3.6.dist-info/METADATA,sha256=gxwj6cYpX-LDDSgoEQeIGAkeBuxrsSelggU47MOg4hw,18509
-hh_applicant_tool-0.3.6.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-hh_applicant_tool-0.3.6.dist-info/entry_points.txt,sha256=Vb7M2YaYLMtKYJZh8chIrXZApMzSRFT1-rQw-U9r10g,65
-hh_applicant_tool-0.3.6.dist-info/RECORD,,
+hh_applicant_tool/utils.py,sha256=lHQh94CEwWp14Ty50ecZPcR3YyqLDVlmgmZlrBiBgHQ,2557
+hh_applicant_tool-0.3.8.dist-info/METADATA,sha256=8Y-ENQv2YFch_NRkreNl594ZqtAygTcVdNGTxBcHk8M,20561
+hh_applicant_tool-0.3.8.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+hh_applicant_tool-0.3.8.dist-info/entry_points.txt,sha256=Vb7M2YaYLMtKYJZh8chIrXZApMzSRFT1-rQw-U9r10g,65
+hh_applicant_tool-0.3.8.dist-info/RECORD,,