@nurseiit_sharip/jobber
v1.0.3
Published
Локальный персональный ассистент поиска работы по Telegram (provider-agnostic). CLI управления установкой, версиями и расписанием; интеллект — в Claude Code через MCP.
Maintainers
Readme
Jobber
Локальный персональный ассистент поиска работы по Telegram. Отдаёшь резюме и Telegram-ключи — получаешь свежие подходящие вакансии из своих чатов, групп, сообществ и каналов (включая архив), каждую с готовым черновиком сопроводительного письма и скором релевантности 0–100.
- Минимум времени. Настройка один раз (
/onboard), дальше/scanили дайджест по расписанию. - Read-only. Ничего не отправляется автоматически. Сопроводительные — только черновики под ревью.
- Provider-agnostic. Telegram сейчас; LinkedIn и веб-доски — заложены на будущее.
Почему не HeadHunter: соискательский API закрыт с 15.12.2025. Источник — Telegram (user-session, MTProto).
Установка (npm / yarn)
Jobber ставится как глобальный CLI. Данные и Python-движок живут в ~/.jobber (отдельно от кода).
# из npm registry:
npm i -g @nurseiit_sharip/jobber # или: yarn global add @nurseiit_sharip/jobber
npm i -g @nurseiit_sharip/[email protected] # конкретная версия
# из GitHub (по git-тегам, без npm):
npm i -g github:nurs3it/jobber # или: ...#v1.0.0
jobber setup # venv, зависимости, регистрация в Claude CodeЗатем в Claude Code:
/onboard # резюме (pdf/docx/img) + Telegram-ключи + первый логин
/scan # разовый проход по диалогам и архиву
/digest # дайджест в Obsidian + отчёт в чатКоманды CLI
| Команда | Назначение |
|---|---|
| jobber install [версия] | Установить/настроить (опц. конкретную версию). |
| jobber update | Обновить до последней версии. |
| jobber downdate | Откатить на предыдущую версию. |
| jobber install-version <v> · use <v> | Поставить конкретную версию. |
| jobber versions | Список доступных версий (git-теги / npm). |
| jobber release [patch\|minor\|major\|x.y.z] | Bump версии + git-тег + push (+ публикация в npm при NPM_TOKEN). |
| jobber remove [--purge] | Удалить (с --purge — вместе с данными ~/.jobber). |
| jobber login | Вход в Telegram (код + 2FA). |
| jobber extract <файл> | Извлечь текст из резюме. |
| jobber schedule on\|off | Ежедневный дайджест по расписанию. |
| jobber status · version | Диагностика и версия. |
Канал версий определяется при установке (GitHub-теги или npm). Переопределить:
--github/--npm.
Релиз новой версии (для мейнтейнера)
Из исходного git-клона одной командой:
NPM_TOKEN=<токен-с-bypass-2FA> jobber release patch # 1.0.0 → 1.0.1: bump + tag + push + publish
# без NPM_TOKEN — только bump+tag+push, публикацию сделает GitHub Actions по тегу
jobber release minor # 1.0.x → 1.1.0
jobber release 2.0.0 # явная версияКоманда синхронизирует версию в package.json и pyproject.toml, коммитит release: vX.Y.Z,
ставит тег и пушит. Выберите один способ публикации (локально через NPM_TOKEN или CI-секрет),
иначе вторая попытка упадёт на дубликате версии.
Установка из исходников (dev)
git clone https://github.com/nurs3it/jobber && cd jobber
npm link # делает доступным CLI `jobber` из репозитория
jobber setupДокументация
- Настройка:
.claude/docs/setup.md— api_id/api_hash, первый логин, импорт CV, первый scan. - Архитектура:
.claude/docs/architecture.md— ядро, источники, конвейер, диаграмма. - Добавить источник:
.claude/docs/adding-a-source.md— интерфейс, capability-флаги, маппинг. - Эксплуатация:
.claude/docs/runbook.md— расписание, где файлы. - Безопасность:
.claude/docs/security.md— модель угроз, файл сессии, read-only. - Проблемы:
.claude/docs/troubleshooting.md— flood-wait, протухшая сессия, OCR, дубликаты, пустой дайджест.
🔒 Безопасность
Файл сессии Telethon (*.session) = полный доступ к Telegram-аккаунту. Только локально, в .gitignore,
никогда не коммитить и не логировать. Подробнее — .claude/docs/security.md и CLAUDE.md.
