hh-applicant-tool 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

hh_applicant_tool/api/client.py

@@ -12,11 +12,12 @@ from urllib.parse import urlencode
 
 import requests
 from requests import Response, Session
+import random
 
 from ..constants import (
     ANDROID_CLIENT_ID,
     ANDROID_CLIENT_SECRET,
-    DEFAULT_USER_AGENT,
+    USER_AGENT_TEMPLATE,
 )
 from ..types import AccessToken
 from . import errors
@@ -38,6 +39,7 @@ class BaseClient:
     user_agent: str | None = None
     session: Session | None = None
     previous_request_time: float = 0.0
+    delay: float = 0.334
 
     def __post_init__(self) -> None:
         self.lock = Lock()
@@ -46,11 +48,31 @@ class BaseClient:
             session.headers.update(
                 {
                     **self.additional_headers(),
-                    "User-Agent": self.user_agent or DEFAULT_USER_AGENT,
+                    "User-Agent": self.user_agent or self.default_user_agent(),
                 }
             )
             logger.debug("Default Headers: %r", session.headers)
 
+    def default_user_agent(self) -> str:
+        return USER_AGENT_TEMPLATE % (
+            random.choice(["8.0", "8.1", "9", "10", "11", "12"]),
+            random.choice(
+                [
+                    "SM-G998B",  # Samsung Galaxy S21 Ultra
+                    "Pixel 6",  # Google Pixel 6
+                    "Mi 11",  # Xiaomi Mi 11
+                    "OnePlus 9",  # OnePlus 9
+                    "P40",  # Huawei P40
+                    "LG G8",  # LG G8
+                    "Xperia 1 II",  # Sony Xperia 1 II
+                    "Moto G Power",  # Motorola Moto G Power
+                    "HTC U12+",  # HTC U12+
+                    "ROG Phone 5",  # Asus ROG Phone 5
+                ]
+            ),
+            random.randint(88, 130),
+        )
+
     def additional_headers(
         self,
     ) -> dict[str, str]:
@@ -61,7 +83,7 @@ class BaseClient:
         method: ALLOWED_METHODS,
         endpoint: str,
         params: dict | None = None,
-        delay: float = 0.34,
+        delay: float | None = None,
         **kwargs: Any,
     ) -> dict:
         # Не знаю насколько это "правильно"
@@ -72,7 +94,9 @@ class BaseClient:
         with self.lock:
             # На серваке какая-то анти-DDOS система
             if (
-                delay := delay - time.monotonic() + self.previous_request_time
+                delay := (self.delay if delay is None else delay)
+                - time.monotonic()
+                + self.previous_request_time
             ) > 0:
                 logger.debug("wait %fs before request", delay)
                 time.sleep(delay)

hh_applicant_tool/constants.py

@@ -1,4 +1,4 @@
-DEFAULT_USER_AGENT = "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36"
+USER_AGENT_TEMPLATE = "Mozilla/5.0 (Linux; Android %s; %s) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%s.0.0.0 Mobile Safari/537.36"
 
 ANDROID_CLIENT_ID = (
     "HIOMIAS39CA9DICTA7JIO64LQKQJF5AGIK74G9ITJKLNEDAOH5FHS5G1JI7FOEGD"

hh_applicant_tool/main.py

@@ -9,14 +9,12 @@ from os import getenv
 from pathlib import Path
 from pkgutil import iter_modules
 from typing import Sequence
-
+from .api import ApiClient
 from .color_log import ColorHandler
 from .utils import Config, get_config_path
 
 DEFAULT_CONFIG_PATH = (
-    get_config_path()
-    / __package__.replace("_", "-")
-    / "config.json"
+    get_config_path() / __package__.replace("_", "-") / "config.json"
 )
 
 logger = logging.getLogger(__package__)
@@ -35,6 +33,18 @@ OPERATIONS = "operations"
 class Namespace(argparse.Namespace):
     config: Config
     verbosity: int
+    delay: float
+
+
+def get_api(args: Namespace) -> ApiClient:
+    token = args.config.get("token", {})
+    api = ApiClient(
+        access_token=token.get("access_token"),
+        refresh_token=token.get("refresh_token"),
+        user_agent=args.config["user_agent"],
+        delay=args.delay,
+    )
+    return api
 
 
 class HHApplicantTool:
@@ -45,32 +55,46 @@ class HHApplicantTool:
     Группа поддержки: <https://t.me/+aSjr8qM_AP85ZDBi>
     """
 
+    class ArgumentFormatter(
+        argparse.ArgumentDefaultsHelpFormatter,
+        argparse.RawDescriptionHelpFormatter,
+    ):
+        pass
+
     def create_parser(self) -> argparse.ArgumentParser:
         parser = argparse.ArgumentParser(
             description=self.__doc__,
-            formatter_class=argparse.RawDescriptionHelpFormatter,
+            formatter_class=self.ArgumentFormatter,
         )
         parser.add_argument(
             "-c",
             "--config",
-            help="config path",
+            help="Путь до файла конфигурации",
             type=Config,
             default=Config(DEFAULT_CONFIG_PATH),
         )
         parser.add_argument(
             "-v",
             "--verbosity",
-            help="increase verbosity",
+            help="При использовании от одного и более раз увеличивает количество отладочной информации в выводе",
             action="count",
             default=0,
         )
+        parser.add_argument(
+            "-d",
+            "--delay",
+            type=float,
+            default=0.334,
+            help="Задержка между запросами к API HH",
+        )
         subparsers = parser.add_subparsers(help="commands")
         package_dir = Path(__file__).resolve().parent / OPERATIONS
         for _, module_name, _ in iter_modules([str(package_dir)]):
             mod = import_module(f"{__package__}.{OPERATIONS}.{module_name}")
             op: BaseOperation = mod.Operation()
             op_parser = subparsers.add_parser(
-                module_name.replace("_", "-"), description=op.__doc__
+                module_name.replace("_", "-"),
+                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

@@ -8,11 +8,11 @@ from typing import TextIO, Tuple
 
 from ..api import ApiClient, ApiError, BadRequest
 from ..main import BaseOperation
-from ..main import Namespace as BaseNamespace
+from ..main import Namespace as BaseNamespace, get_api
 from ..telemetry_client import TelemetryError
 from ..telemetry_client import get_client as get_telemetry_client
 from ..types import ApiListResponse, VacancyItem
-from ..utils import fix_datetime, print_err, truncate_string
+from ..utils import fix_datetime, print_err, truncate_string, random_text
 
 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]:
@@ -83,16 +99,13 @@ class Operation(BaseOperation):
         return min(min_interval, max_interval), max(min_interval, max_interval)
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         resume_id = self._get_resume_id(args, api)
         application_messages = self._get_application_messages(args)
 
         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,
@@ -103,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:
@@ -122,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
 
@@ -140,8 +153,11 @@ 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()
         telemetry_data = defaultdict(dict)
@@ -158,33 +174,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 IndexError:
-                    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"),
@@ -193,11 +300,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,
@@ -205,19 +310,23 @@ class Operation(BaseOperation):
                     "message": "",
                 }
 
-                if vacancy.get("response_letter_required"):
-                    message_template = random.choice(application_messages)
-
-                    try:
-                        params["message"] = template_message % 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 == {}
@@ -229,12 +338,16 @@ 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/operations/call_api.py

@@ -4,8 +4,8 @@ import json
 import logging
 import sys
 
-from ..api import ApiClient, ApiError
-from ..main import BaseOperation
+from ..api import ApiError
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 
 logger = logging.getLogger(__package__)
@@ -34,11 +34,7 @@ class Operation(BaseOperation):
         )
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         params = dict(x.split("=", 1) for x in args.param)
         try:
             result = api.request(args.method, args.endpoint, params=params)

hh_applicant_tool/operations/clear_negotiations.py

@@ -5,7 +5,7 @@ from datetime import datetime, timedelta, timezone
 
 from ..api import ApiClient, ClientError
 from ..constants import INVALID_ISO8601_FORMAT
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
 from ..utils import print_err, truncate_string
@@ -51,11 +51,7 @@ class Operation(BaseOperation):
         return rv
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         negotiations = self._get_active_negotiations(api)
         print("Всего активных:", len(negotiations))
         for item in negotiations:

hh_applicant_tool/operations/list_resumes.py

@@ -5,7 +5,7 @@ import logging
 from prettytable import PrettyTable
 
 from ..api import ApiClient
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
 from ..utils import truncate_string
@@ -24,11 +24,7 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         resumes: ApiListResponse = api.get("/resumes/mine")
         t = PrettyTable(
             field_names=["ID", "Название", "Статус"], align="l", valign="t"

hh_applicant_tool/operations/update_resumes.py

@@ -3,7 +3,7 @@ import argparse
 import logging
 
 from ..api import ApiClient, ApiError
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
 from ..utils import print_err, truncate_string
@@ -22,11 +22,7 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         resumes: ApiListResponse = api.get("/resumes/mine")
         for resume in resumes["items"]:
             try:

hh_applicant_tool/operations/whoami.py

@@ -4,7 +4,7 @@ import json
 import logging
 
 from ..api import ApiClient
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 
 logger = logging.getLogger(__package__)
@@ -21,10 +21,6 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         result = api.get("/me")
         print(json.dumps(result, ensure_ascii=True, indent=2, sort_keys=True))

hh_applicant_tool/telemetry_client.py

@@ -51,8 +51,6 @@ class TelemetryClient:
         :raises TelemetryError: Если произошла ошибка при отправке или декодировании JSON.
         """
         url = urljoin(self.server_address, endpoint)
-        logger.debug(data)
-
         try:
             response = self.session.post(url, json=data)
             # response.raise_for_status()

hh_applicant_tool/utils.py

@@ -10,6 +10,7 @@ from threading import Lock
 from typing import Any
 from os import getenv
 from .constants import INVALID_ISO8601_FORMAT
+import re, random
 
 print_err = partial(print, file=sys.stderr, flush=True)
 
@@ -72,3 +73,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.5.dist-info → hh_applicant_tool-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.3.5
+Version: 0.3.7
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -19,8 +19,6 @@ Description-Content-Type: text/markdown
 
 ## HH Applicant Tool
 
-> ! Наложен мораторий на доработки/переработки. Разработка будет возобновлена после 100 звезд 💫
-
 ![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)]() 
@@ -32,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> они просто идиотки... И я тупо стал спамить как они. Мне уже было просто лень читать весь этот бред, что пишут долбоебы в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое.
 
@@ -56,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
 # Версия с поддержкой авторизации через запуск окна с браузером (эта версия очень много весит)
@@ -72,18 +72,18 @@ $ pipx upgrade hh-applicant-tool
 
 Отдельно я распишу процесс установки в **Windows** в подробностях:
 
-* Для начала поставьте Python 3 любым удобным способом.
-* Запустите терминал/консоль от Администратора и выполните:
+* Для начала поставьте последнюю версию **Python 3** любым удобным способом.
+* Запустите **Terminal** или **PowerShell** от Администратора и выполните:
   ```ps
   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
   ```
-  Без этой настройки не будут работать виртуальные окружения.
+  Данная политика разрешает текущему пользователю (от которого зашли) запускать скрипты. Без нее не будут работать виртуальные окружения.
 * Создайте и активируйте виртуальное окружение:
   ```ps
   PS> python -m pip venv hh-applicant-venv
   PS> .\hh-applicant-venv\Scripts\activate
   ```
-* Поставьте все пакеты в виртуальное окружение `hh-applicant-tool`:
+* Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
   ```ps
   (hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
   ```
@@ -91,11 +91,92 @@ $ pipx upgrade hh-applicant-tool
   ```ps
   (hh-applicant-venv) PS> hh-applicant-tool -h
   ```
-* В случае неудачи, вернитесь к первому шагу. Для последующих запусков сперва активируйте виртуальное окружение.
-  
+* В случае неудачи вернитесь к первому шагу.
+* Для последующих запусков сначала активируйте виртуальное окружение.
+
+### Авторизация
+
+```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`:
 
+```json
+{
+  "user_agent": "Mozilla/5.0 YablanBrowser"
+}
+```
 
-Использование:
+### Описание команд
 
 ```bash
 $ hh-applicant-tool [ GLOBAL_FLAGS ] [ OPERATION [ OPERATION_FLAGS  ] ]
@@ -158,111 +239,52 @@ https://hh.ru/employer/1918903
 | **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
+| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Контакты получаются строго из публичного доступа, например, с сайта фирмы и могут быть удалены только по просьбе уполнамоченного лица. Данная функция готова и будет доступна после 100 ⭐  |
 
-Авторизуемся:
+### Формат текста сообщений
 
-```bash
-$ hh-applicant-tool -vv authorize
-```
+Команда `apply-similar` поддерживает специальный формат сообщений.
 
-![image](https://github.com/user-attachments/assets/88961e31-4ea3-478f-8c43-914d6785bc3b)
+Так же в сообщении можно использовать плейсхолдеры:
 
-> В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
+- **`%(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. Название вакансии.
 1. Тип вакансии (открытая/закрытая).
@@ -271,7 +293,7 @@ rm -f ~/.local/share/applications/hhandroid.desktop
 1. Прямая ссылка на вакансию.
 1. Дата создания вакансии.
 1. Дата публикации вакансии.
-1. Контактная информация хрюши (ее телефон, email и тп).
+1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, которая в дальнейшем _может_ храниться в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля. Данная информация может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и подписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова.
 1. Название компании.
 1. Тип компании.
 1. Описание компании.

hh_applicant_tool-0.3.7.dist-info/RECORD

@@ -0,0 +1,24 @@
+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/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/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hh_applicant_tool/operations/apply_similar.py,sha256=SbSrZPbQkOcDqbuV8mqX9lMRsvBYLwq3xVnpQcbM3Q0,17166
+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
+hh_applicant_tool/operations/list_resumes.py,sha256=XBrVFTnl45BUtuvjVm70h_CXZrOvAULnLkLkyUh7gxw,1134
+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/types.py,sha256=q3yaIcq-UOkPzjxws0OFa4w9fTty-yx79_dic70_dUM,843
+hh_applicant_tool/utils.py,sha256=DKD1b4mItuUugP6aV2vEoO59cIU2mJp5twc8WdvaSA4,2551
+hh_applicant_tool-0.3.7.dist-info/METADATA,sha256=hYTuJoXxmRrCEnvcvdJz4AJEFKm6nHL6o2udu0Bi1bI,20109
+hh_applicant_tool-0.3.7.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+hh_applicant_tool-0.3.7.dist-info/entry_points.txt,sha256=Vb7M2YaYLMtKYJZh8chIrXZApMzSRFT1-rQw-U9r10g,65
+hh_applicant_tool-0.3.7.dist-info/RECORD,,

hh_applicant_tool-0.3.5.dist-info/RECORD

@@ -1,24 +0,0 @@
-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=z_YMsd5zL4-1_aIbkEKqm_1m_mZkm3BMxlAQuCoNj2Y,7040
-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=YdNz0CF4swJ9OO5vVpOZ39RP-05xSU0Ghw4Y6BhISoE,468
-hh_applicant_tool/main.py,sha256=XLKsd8mpCKuFoP3ESMpgJKdGL3m6tOQ8kKrOzCN-dwA,3075
-hh_applicant_tool/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hh_applicant_tool/operations/apply_similar.py,sha256=RUV-hVyZZGEBBM7sfi7Ssg5c4plyc2JNETlL5PoDpPY,12875
-hh_applicant_tool/operations/authorize.py,sha256=TyUTCSOGwSYVJMEd5vSI981LRRI-RZf8hnlVYhtRVwA,3184
-hh_applicant_tool/operations/call_api.py,sha256=oWAfvy4LwbsQ8HsgI_3en3sMTlu3ZWU7NzpxssrUNSU,1472
-hh_applicant_tool/operations/clear_negotiations.py,sha256=5ybdJMUfV9XYxnn2y4zvWdS_ZE8yXAbFJoXOMyqetw8,4041
-hh_applicant_tool/operations/list_resumes.py,sha256=HYxjDALrWl_YBIitDldhhEs-WO_0e_2FGw586MSdsuE,1281
-hh_applicant_tool/operations/refresh_token.py,sha256=hYTmzBzJFSsb-LDO2_w0Y30WVWsctIH7vTzirkLwzWo,1267
-hh_applicant_tool/operations/update_resumes.py,sha256=FKtwEL7i0vaOxLEn1nARi72SuMYB5VjN6Fihe6rlt-Y,1196
-hh_applicant_tool/operations/whoami.py,sha256=kdLQ_FjYzpJPKxFlocxf7vgXhW1zocb0bd5IAWmsQuA,861
-hh_applicant_tool/telemetry_client.py,sha256=TlsNKlclPyJqLPO0xHkHKBIhT8bmgx1ZBup4PjE8w5E,2296
-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.5.dist-info/METADATA,sha256=qUVl-yMhKOXWP6AhIIwdu5AFYX05npx9lQvsRMXYbx8,17247
-hh_applicant_tool-0.3.5.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-hh_applicant_tool-0.3.5.dist-info/entry_points.txt,sha256=Vb7M2YaYLMtKYJZh8chIrXZApMzSRFT1-rQw-U9r10g,65
-hh_applicant_tool-0.3.5.dist-info/RECORD,,