hh-applicant-tool 0.5.1__tar.gz → 0.5.3__tar.gz

{hh_applicant_tool-0.5.1 → hh_applicant_tool-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.5.1
+Version: 0.5.3
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -32,7 +32,9 @@ Description-Content-Type: text/markdown
 
 ### Описание
 
-Утилита для успешных волчат, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме. Но данная утилита больше чем просто спамилка отзывами, вы так же выступаете в роли тайного агента, и если в списке подходящих вакансий встречается отказ, она возвращает ссылку на обсуждение работодателя в группе [Отзывы о работодателях с HH.RU](https://t.me/otzyvy_headhunter). Там вы можете написать отзыв о работодателе и почитать чужие. Для этого собираются данные о работодателях и их вакансиях (персональные данные пользователя не передаются ни в каком виде). Отправку данных на сервер разработчика можно отключить, но тогда вы не получите ссылку на обсуждение, а так же не сможете пожаловаться на неадекватного мудака, выкатившего отказ после "небольшого" тестового задания на недельку. Через сайты на таких жаловаться бесполезно: владелец сайта за деньги или после угроз судом удаляют отзывы. Единственное место где можно написать отзыв — это **Telegram**. 
+> Утилита для генерации сопроводительного письма может использовать AI
+
+Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Но данная утилита больше чем просто спамилка откликами, вы так же выступаете в роли тайного агента, и если в списке подходящих вакансий встречается отказ, она возвращает ссылку на обсуждение работодателя в группе [Отзывы о работодателях с HH.RU](https://t.me/otzyvy_headhunter). Там вы можете написать отзыв о работодателе и почитать чужие. Для этого собираются данные о работодателях и их вакансиях (персональные данные пользователя не передаются ни в каком виде). Отправку данных на сервер разработчика можно отключить, но тогда вы не получите ссылку на обсуждение, а так же не сможете пожаловаться на неадекватного мудака, выкатившего отказ после "небольшого" тестового задания на недельку. Через сайты на таких жаловаться бесполезно: владелец сайта за деньги или после угроз судом удаляют отзывы. Единственное место где можно написать отзыв — это **Telegram**. 
 
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще.
@@ -43,11 +45,10 @@ asdf/pyenv/conda и что-то еще.
 
 ![image](https://github.com/user-attachments/assets/a0cce1aa-884b-4d84-905a-3bb207eba4a3)
 
+> Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
 
 ### Предыстория
 
-Был один знакомый знакомого, который работал хрюшей. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отличить Java от JavaScript, но я думаю, что <s>в значительном числе случаев, тут имеют место такие вот рассылки</s> они просто идиотки... И я тупо стал спамить как они. Мне уже было просто лень читать весь этот бред, что пишут долбоебы в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое.
-
 Долгое время я делал массовые заявки с помощью консоли браузера:
 
 ```js
@@ -167,6 +168,11 @@ $ hh-applicant-tool refresh-token
 | **macOS**                  | `~/Library/Application Support/hh-applicant-tool/config.json`       |
 | **Linux**                  | `~/.config/hh-applicant-tool/config.json`                           |
 
+Полный путь до конфигурационного файла можно вывести с помощью команды:
+
+```bash
+hh-applicant-tool config -p
+```
 
 Через конфиг можно задать дополнительные настройки:
 
@@ -239,11 +245,12 @@ https://hh.ru/employer/1918903
 | **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан. |
 | **reply-employers** | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
+| **config**      | Редактировать конфигурационный файл. |
 | **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Это  функционал для избранных, но в группе есть бесплатный бот с тем же функционалом. |
 
 ### Формат текста сообщений
@@ -277,6 +284,31 @@ https://hh.ru/employer/1918903
 Привет, как ты?
 ```
 
+### Использование AI для генерации сопроводительного письма
+
+* Перейдите на сайт [blackbox.ai](https://www.blackbox.ai) и создайте чат. 
+* В первом сообщении опишите свой опыт и тп. 
+* Далее откройте devtools, нажав `F12`. 
+* Во вкладке `Network` последним должен быть POST-запрос на `https://www.blackbox.ai/api/chat`. 
+* Запустите редактирование конфига:
+    ```sh
+    hh-applicant-tool config
+    ```
+* Измените конфиг:
+    ```json
+    {
+        // ...
+        "blackbox": {
+            "session_id": "<В заголовках запроса найдите Cookie, скопируйте сюда значение sessionId до ;>",
+            "chat_payload": <Сюда вставьте тело запроса типа {"messages":[{"id":"IXqdOx9","content":"Я программист fullstack-разработчик...","role":"user"}],"id":"IXqdOx9","previewToken":null,"userId":null,...,"webSearchModePrompt":false,"deepSearchMode":false}>
+        }
+    }
+    ```
+* Пример рассылки откликов с генерированным письмом:
+    ```sh
+    hh-applicant-tool apply-similar -f --ai
+    ```
+
 ### Написание плагинов
 
 Утилита использует систему плагинов. Все они лежат в [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).

{hh_applicant_tool-0.5.1 → hh_applicant_tool-0.5.3}/README.md

@@ -13,7 +13,9 @@
 
 ### Описание
 
-Утилита для успешных волчат, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме. Но данная утилита больше чем просто спамилка отзывами, вы так же выступаете в роли тайного агента, и если в списке подходящих вакансий встречается отказ, она возвращает ссылку на обсуждение работодателя в группе [Отзывы о работодателях с HH.RU](https://t.me/otzyvy_headhunter). Там вы можете написать отзыв о работодателе и почитать чужие. Для этого собираются данные о работодателях и их вакансиях (персональные данные пользователя не передаются ни в каком виде). Отправку данных на сервер разработчика можно отключить, но тогда вы не получите ссылку на обсуждение, а так же не сможете пожаловаться на неадекватного мудака, выкатившего отказ после "небольшого" тестового задания на недельку. Через сайты на таких жаловаться бесполезно: владелец сайта за деньги или после угроз судом удаляют отзывы. Единственное место где можно написать отзыв — это **Telegram**. 
+> Утилита для генерации сопроводительного письма может использовать AI
+
+Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Но данная утилита больше чем просто спамилка откликами, вы так же выступаете в роли тайного агента, и если в списке подходящих вакансий встречается отказ, она возвращает ссылку на обсуждение работодателя в группе [Отзывы о работодателях с HH.RU](https://t.me/otzyvy_headhunter). Там вы можете написать отзыв о работодателе и почитать чужие. Для этого собираются данные о работодателях и их вакансиях (персональные данные пользователя не передаются ни в каком виде). Отправку данных на сервер разработчика можно отключить, но тогда вы не получите ссылку на обсуждение, а так же не сможете пожаловаться на неадекватного мудака, выкатившего отказ после "небольшого" тестового задания на недельку. Через сайты на таких жаловаться бесполезно: владелец сайта за деньги или после угроз судом удаляют отзывы. Единственное место где можно написать отзыв — это **Telegram**. 
 
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще.
@@ -24,11 +26,10 @@ asdf/pyenv/conda и что-то еще.
 
 ![image](https://github.com/user-attachments/assets/a0cce1aa-884b-4d84-905a-3bb207eba4a3)
 
+> Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
 
 ### Предыстория
 
-Был один знакомый знакомого, который работал хрюшей. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отличить Java от JavaScript, но я думаю, что <s>в значительном числе случаев, тут имеют место такие вот рассылки</s> они просто идиотки... И я тупо стал спамить как они. Мне уже было просто лень читать весь этот бред, что пишут долбоебы в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое.
-
 Долгое время я делал массовые заявки с помощью консоли браузера:
 
 ```js
@@ -148,6 +149,11 @@ $ hh-applicant-tool refresh-token
 | **macOS**                  | `~/Library/Application Support/hh-applicant-tool/config.json`       |
 | **Linux**                  | `~/.config/hh-applicant-tool/config.json`                           |
 
+Полный путь до конфигурационного файла можно вывести с помощью команды:
+
+```bash
+hh-applicant-tool config -p
+```
 
 Через конфиг можно задать дополнительные настройки:
 
@@ -220,11 +226,12 @@ https://hh.ru/employer/1918903
 | **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками, иначе рискуете попасть в теневой бан. |
 | **reply-employers** | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
+| **config**      | Редактировать конфигурационный файл. |
 | **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Это  функционал для избранных, но в группе есть бесплатный бот с тем же функционалом. |
 
 ### Формат текста сообщений
@@ -258,6 +265,31 @@ https://hh.ru/employer/1918903
 Привет, как ты?
 ```
 
+### Использование AI для генерации сопроводительного письма
+
+* Перейдите на сайт [blackbox.ai](https://www.blackbox.ai) и создайте чат. 
+* В первом сообщении опишите свой опыт и тп. 
+* Далее откройте devtools, нажав `F12`. 
+* Во вкладке `Network` последним должен быть POST-запрос на `https://www.blackbox.ai/api/chat`. 
+* Запустите редактирование конфига:
+    ```sh
+    hh-applicant-tool config
+    ```
+* Измените конфиг:
+    ```json
+    {
+        // ...
+        "blackbox": {
+            "session_id": "<В заголовках запроса найдите Cookie, скопируйте сюда значение sessionId до ;>",
+            "chat_payload": <Сюда вставьте тело запроса типа {"messages":[{"id":"IXqdOx9","content":"Я программист fullstack-разработчик...","role":"user"}],"id":"IXqdOx9","previewToken":null,"userId":null,...,"webSearchModePrompt":false,"deepSearchMode":false}>
+        }
+    }
+    ```
+* Пример рассылки откликов с генерированным письмом:
+    ```sh
+    hh-applicant-tool apply-similar -f --ai
+    ```
+
 ### Написание плагинов
 
 Утилита использует систему плагинов. Все они лежат в [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).

hh_applicant_tool-0.5.3/hh_applicant_tool/ai/blackbox.py

@@ -0,0 +1,55 @@
+import logging
+from copy import deepcopy
+
+import requests
+
+logger = logging.getLogger(__package__)
+
+
+class BlackboxError(Exception):
+    pass
+
+
+class BlackboxChat:
+    chat_endpoint: str = "https://www.blackbox.ai/api/chat"
+
+    def __init__(
+        self,
+        session_id: str,
+        chat_payload: dict,
+        proxies: dict[str, str] = {},
+        session: requests.Session | None = None,
+    ):
+        self.session_id = session_id
+        self.chat_payload = chat_payload
+        self.proxies = proxies
+        self.session = session or requests.session()
+
+    def default_headers(self) -> dict[str, str]:
+        return {
+            "Accept": "*/*",
+            "Accept-Language": "en-US,en;q=0.9,ru;q=0.8",
+            "Content-Type": "application/json",
+            "Origin": "https://www.blackbox.ai",
+            "Priority": "u=0",
+            "Referer": "https://www.blackbox.ai/",
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        }
+
+    def send_message(self, message: str) -> str:
+        payload = deepcopy(self.chat_payload)
+        payload["messages"].append(
+            {**payload["messages"][0], "content": message}
+        )
+
+        try:
+            response = self.session.post(
+                self.chat_endpoint,
+                json=payload,
+                cookies={"sessionId": self.session_id},
+                headers=self.default_headers(),
+                proxies=self.proxies,
+            )
+            return response.text
+        except requests.exceptions.RequestException as ex:
+            raise BlackboxError(str(ex)) from ex

{hh_applicant_tool-0.5.1 → hh_applicant_tool-0.5.3}/hh_applicant_tool/operations/apply_similar.py

@@ -6,6 +6,7 @@ from collections import defaultdict
 from datetime import datetime, timedelta, timezone
 from typing import TextIO, Tuple
 
+from ..ai.blackbox import BlackboxChat, BlackboxError
 from ..api import ApiError, BadRequest
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
@@ -15,6 +16,7 @@ from ..telemetry_client import TelemetryClient, TelemetryError
 from ..types import ApiListResponse, VacancyItem
 from ..utils import (fix_datetime, parse_interval, parse_invalid_datetime,
                      random_text, truncate_string)
+from hh_applicant_tool.ai import blackbox
 
 logger = logging.getLogger(__package__)
 
@@ -23,8 +25,10 @@ class Namespace(BaseNamespace):
     resume_id: str | None
     message_list: TextIO
     force_message: bool
-    apply_interval: Tuple[float, float]
-    page_interval: Tuple[float, float]
+    use_ai: bool
+    pre_prompt: str
+    apply_interval: tuple[float, float]
+    page_interval: tuple[float, float]
     order_by: str
     search: str
     dry_run: bool
@@ -36,16 +40,32 @@ class Operation(BaseOperation, GetResumeIdMixin):
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         parser.add_argument("--resume-id", help="Идентефикатор резюме")
         parser.add_argument(
+            "-L",
             "--message-list",
             help="Путь до файла, где хранятся сообщения для отклика на вакансии. Каждое сообщение — с новой строки.",
             type=argparse.FileType(),
         )
         parser.add_argument(
+            "-f",
             "--force-message",
+            "--force",
             help="Всегда отправлять сообщение при отклике",
             default=False,
             action=argparse.BooleanOptionalAction,
         )
+        parser.add_argument(
+            "--use-ai",
+            "--ai",
+            help="Использовать AI для генерации сообщений",
+            default=False,
+            action=argparse.BooleanOptionalAction,
+        )
+        parser.add_argument(
+            "--pre-prompt",
+            "--prompt",
+            help="Добавочный промпт для генерации сопроводительного письма",
+            default="Сгенерируй сопроводительное письмо не более 5-7 предложений от моего имени для вакансии",
+        )
         parser.add_argument(
             "--apply-interval",
             help="Интервал перед отправкой откликов в секундах (X, X-Y)",
@@ -104,6 +124,16 @@ class Operation(BaseOperation, GetResumeIdMixin):
         self.application_messages = self._get_application_messages(
             args.message_list
         )
+        self.chat = None
+
+        if config := args.config.get("blackbox"):
+            self.chat = BlackboxChat(
+                session_id=config["session_id"],
+                chat_payload=config["chat_payload"],
+                proxies=self.api.proxies or {},
+            )
+
+        self.pre_prompt = args.pre_prompt
 
         self.apply_min_interval, self.apply_max_interval = args.apply_interval
         self.page_min_interval, self.page_max_interval = args.page_interval
@@ -255,7 +285,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
 
                 if not do_apply:
                     logger.debug(
-                        "Проопускаем вакансию так как достигла лимита заявок: %s",
+                        "Пропускаем вакансию так как достигла лимита заявок: %s",
                         vacancy["alternate_url"],
                     )
                     continue
@@ -276,11 +306,25 @@ class Operation(BaseOperation, GetResumeIdMixin):
                 if self.force_message or vacancy.get(
                     "response_letter_required"
                 ):
-                    msg = params["message"] = (
-                        random_text(random.choice(self.application_messages))
-                        % message_placeholders
-                    )
+                    if self.chat:
+                        try:
+                            msg = self.pre_prompt + "\n\n"
+                            msg += message_placeholders["vacancy_name"]
+                            logger.debug(msg)
+                            msg = self.chat.send_message(msg)
+                        except BlackboxError as ex:
+                            logger.error(ex)
+                            continue
+                    else:
+                        msg = (
+                            random_text(
+                                random.choice(self.application_messages)
+                            )
+                            % message_placeholders
+                        )
+
                     logger.debug(msg)
+                    params["message"] = msg
 
                 if self.dry_run:
                     logger.info(

{hh_applicant_tool-0.5.1 → hh_applicant_tool-0.5.3}/hh_applicant_tool/operations/clear_negotiations.py

@@ -5,8 +5,9 @@ from datetime import datetime, timedelta, timezone
 
 from ..api import ApiClient, ClientError
 from ..constants import INVALID_ISO8601_FORMAT
-from ..main import BaseOperation, get_api
+from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
+from ..main import get_api
 from ..types import ApiListResponse
 from ..utils import print_err, truncate_string
 
@@ -19,14 +20,21 @@ class Namespace(BaseNamespace):
 
 
 class Operation(BaseOperation):
-    """Отменяет старые заявки, скрывает отказы с опциональной блокировкой работодателя."""
+    """Отменяет старые отклики, скрывает отказы с опциональной блокировкой работодателя."""
 
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         parser.add_argument(
             "--older-than",
             type=int,
             default=30,
-            help="Удалить заявки старше опр. кол-ва дней. По умолчанию: %(default)d",
+            help="Удалить отклики старше опр. кол-ва дней. По умолчанию: %(default)d",
+        )
+        parser.add_argument(
+            "--all",
+            type=bool,
+            default=False,
+            action=argparse.BooleanOptionalAction,
+            help="Удалить все отклики в тч с приглашениями",
         )
         parser.add_argument(
             "--blacklist-discard",
@@ -61,7 +69,8 @@ class Operation(BaseOperation):
             # hidden True
             is_discard = state["id"] == "discard"
             if not item["hidden"] and (
-                is_discard
+                args.all 
+                or is_discard
                 or (
                     state["id"] == "response"
                     and (
@@ -72,7 +81,11 @@ class Operation(BaseOperation):
                     )
                 )
             ):
-                r = api.delete(f"/negotiations/active/{item['id']}")
+                decline_allowed = item.get("decline_allowed") or False
+                r = api.delete(
+                    f"/negotiations/active/{item['id']}",
+                    with_decline_message=decline_allowed,
+                )
                 assert {} == r
                 vacancy = item["vacancy"]
                 print(

hh_applicant_tool-0.5.3/hh_applicant_tool/operations/config.py

@@ -0,0 +1,36 @@
+import argparse
+import logging
+import os
+import subprocess
+
+from ..main import BaseOperation
+from ..main import Namespace as BaseNamespace
+
+logger = logging.getLogger(__package__)
+
+EDITOR = os.getenv("EDITOR", "nano")
+
+
+class Namespace(BaseNamespace):
+    print: bool
+
+
+class Operation(BaseOperation):
+    """Редактировать конфигурационный файл или показать путь до него"""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        parser.add_argument(
+            "-p",
+            "--print",
+            type=bool,
+            default=False,
+            action=argparse.BooleanOptionalAction,
+            help="Напечатать путь и выйти",
+        )
+
+    def run(self, args: Namespace) -> None:
+        config_path = str(args.config._config_path)
+        if args.print:
+            print(config_path)
+        else:
+            subprocess.call([EDITOR, config_path])

{hh_applicant_tool-0.5.1 → hh_applicant_tool-0.5.3}/hh_applicant_tool/operations/reply_employers.py

@@ -160,15 +160,15 @@ class Operation(BaseOperation, GetResumeIdMixin):
                         print("💼", message_placeholders["vacancy_name"])
                         print("📅", vacancy["created_at"])
                         if salary:
-                            salary_from = salary.get("from", "-")
-                            salary_to = salary.get("to", "-")
+                            salary_from = salary.get("from")or "-"
+                            salary_to = salary.get("to")or "-"
                             salary_currency = salary.get("currency")
                             print("💵 от", salary_from, "до", salary_to, salary_currency)
                         print("")
                         print("Последние сообщения:")
                         for msg in (
-                            message_history[:1] + ["..."] + message_history[-2:]
-                            if len(message_history) > 3
+                            message_history[:1] + ["..."] + message_history[-3:]
+                            if len(message_history) > 5
                             else message_history
                         ):
                             print(msg)

{hh_applicant_tool-0.5.1 → hh_applicant_tool-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hh-applicant-tool"
-version = "0.5.1"
+version = "0.5.3"
 description = ""
 authors = ["Senior YAML Developer <yamldeveloper@proton.me>"]
 readme = "README.md"