Worklife — AI job search

Worklife — MCP server for AI job search

Worklife is a local-first Model Context Protocol (MCP) server and career assistant for job seekers. Connect an AI agent to search job boards and employer websites, compare vacancies with your experience, prepare truthful resumes and CVs, and track applications, email, interviews, and offers.

It provides salary and job-market analysis, a local application tracker, browser and API tools, and a shared network of signed employer observations. Your profile, CVs, and correspondence are stored in your personal workspace; the shared knowledge base is for employer information. The agent runs in your MCP client, with an optional built-in model runner.

Website · PyPI · MCP Registry · Agent setup · Discovery and registry publishing · Документация на русском

Install the career agent for your client with Python 3.12+ and uv:

uvx --python 3.12 worklife-agent --target codex

The setup command supports project adapters for Codex, Claude Code, Cursor, and OpenCode; --target generic exports MCP configuration for manual setup. It creates a persistent runtime, installs Chromium, and prepares ~/worklife-career. Open that folder in your client and ask: “Use Worklife. Start with recruiter_start and ask about my job-search goals.” See the client support and setup limits.

For an existing stdio MCP client, the career tools can also run directly from PyPI:

{

"mcpServers": { "worklife_recruiter": { "command": "uvx", "args": ["--python", "3.12", "--from", "worklife-agent==0.5.2", "worklife-recruiter", "mcp"] } } }

This starts the MCP server with local storage at ~/.worklife. Browser automation additionally needs the browser extra and Chromium; the setup command above installs both. Accounts and connectors are configured separately. Worklife does not provide unrestricted access to job platforms.

Worklife на русском

Общую базу можно синхронизировать через отдельную служебную группу Telegram: подписанные блоки, чтение пропущенной истории и подключение новой пустой копии. Настройка и создание группы — Telegram-синхронизация.

Новая сеть без монет и комиссий: протокол и подготовка публичного испытания. Профиль public-testnet-v1 использует отдельный genesis, PoW 25/18 бит и шесть подтверждений. Старые описания GitHub relay ниже относятся к legacy-предложениям.

Страница проекта · Исходный код · Инструкции агента

Инструментарий автономного поиска работы. Человек задаёт цель и условия; агент ищет подходящие предложения, выясняет условия, ведёт переписку, готовит CV, проверяет гипотезы и обменивается проверяемо подписанным опытом с другими участниками.

Версия 0.5: Telegram-синхронизация и P2P-обмен, онбординг, прозрачное состояние базы работодателей и уведомления об обновлениях. Агент самостоятельно выбирает источники поиска, использует браузер и API, отслеживает регистрации, переписку и эксперименты. Можно подключить собственную MCP-среду либо настроить модель для встроенного цикла агента. Фиксированного списка площадок нет; встроенные адаптеры дополняют браузер и настраиваемые API.

Что работает

«Любая платформа» означает расширяемый доступ через API или доступный пользователю браузерный интерфейс. Универсального доступа без аккаунта, разрешений и ограничений самой платформы не существует. OAuth-токены настраиваются владельцем аккаунта; автоматическое OAuth-подключение ко всем сервисам не реализовано. Telegram-адаптер работает от бота, не от личного аккаунта. HH использует существующий resume_id. Greenhouse/Lever здесь читают вакансии; подача заявления — через браузер либо отдельно настроенный разрешённый API.

Быстрый запуск

Одна команда через uv

Установка и подключение выбранного AI-клиента из PyPI:

uvx --python 3.12 worklife-agent --target codex

Вместо codex доступны claude-code, cursor, opencode и другие поддерживаемые проектные адаптеры. generic подготавливает MCP JSON для ручного импорта. Выберите клиент на лендинге и скопируйте готовую команду. Если uv ещё не установлен, используйте официальную инструкцию.

Команда создаёт постоянное окружение в ~/.local/share/worklife, устанавливает текущую версию пакета и Chromium, подготавливает личные данные в ~/.worklife и агента в ~/worklife-career. Затем откройте эту папку в своём AI-клиенте и включите Worklife Recruiter. На Linux установка системных библиотек Chromium для Ubuntu/Debian может запросить пароль администратора.

MCP использует Python постоянного окружения: очистка временного кеша uvx не удаляет установленного агента. Повторная установка сохраняет личную базу и использует существующий установщик адаптеров с его правилами сохранения чужих настроек и резервного копирования. Дополнительные параметры: --destination, --install-dir, --home, --no-browser. --package-source предназначен для проверки конкретного локального wheel до публикации.

Релиз 0.5.2 опубликован в PyPI.

Запуск из исходников

Нужны Python 3.12+ и uv.

git clone https://github.com/dzenlotus/worklife-agent.git

cd worklife-agent uv sync --extra dev --extra browser uv run playwright install chromium cp config.example.toml config.toml cp .env.example .env uv run --env-file .env worklife --config config.toml init

Настройте только нужные аккаунты в .env и параметры провайдеров в config.toml. *_env и headers_env содержат имена переменных, а не сами секреты. Личные данные находятся в .worklife/ рядом с конфигурацией; без конфигурации — в ~/.worklife. WORKLIFE_HOME/--home переопределяют расположение.

Демонстрация без аккаунтов и внешних отправок:

uv run worklife --home artifacts/demo demo

uv run worklife --home artifacts/demo call agent_brief '{}' uv run worklife tools uv run pytest -q

Демо создаёт профиль, два CV, вакансию, гипотезу, черновик, follow-up и вторую локальную копию общей базы; проверяет репликацию и отклонение подделанной записи. Демо-данные явно обозначены как синтетические.

Карьерный агент и установка в AI-клиент

worklife-recruiter устанавливает MCP, инструкции Worklife Recruiter и восемь предметных скиллов. Модель работает внутри вашего AI-клиента; дополнительный ключ модели для этого не нужен.

Первое поручение: «Используй worklife-onboarding. Быстро подключи всё нужное, включая Telegram». Скилл проверяет существующие условия и доступы, настраивает нужные площадки и почту, проводит через локальный вход Telegram и проверку синхронизации. Пароли, коды и сессия вводятся в вашем терминале. При повторном запуске он продолжает недостающие шаги.

Агент при начале разговора и локальное приложение проверяют новые стабильные версии Worklife в PyPI не чаще раза в сутки. При выходе релиза появляется уведомление со ссылкой и кнопкой копирования поручения агенту обновить Worklife. Закрытое уведомление не возвращается для той же версии; сведения о ней остаются в настройках. Обновление запускается отдельно и сохраняет прежние настройки MCP, доступы и личную базу. После обновления пакета обновите нативные инструкции/скиллы прежней командой worklife-recruiter install и перезапустите MCP/приложение. Для запуска через uvx --from worklife-agent==... также обновляется закреплённая версия в настройках запуска MCP: изменение временного окружения uvx само по себе недостаточно. В режиме WORKLIFE_NETWORK_OFFLINE=1 обращения к PyPI нет.

uv run worklife-recruiter targets

uv run worklife-recruiter install --target codex --destination ../worklife-career --config config.toml --env-file .env --dry-run uv run worklife-recruiter install --target codex --destination ../worklife-career --config config.toml --env-file .env

Откройте созданную папку в выбранном клиенте. Установщик показывает созданные файлы и дальнейшие действия. --config указывает ту же личную базу, что и приложение; --env-file передаёт путь к окружению, без копирования секретов в настройки клиента. Без конфигурации и явного --home используется стандартная ~/.worklife. --all готовит конфигурации из каталога; установки в пользовательские настройки выполняются только явно. Подробности, команды для клиентов и границы поддержки: установка агента. Профиль Recruiter включает карьерные операции, recruiter_start и recruiter_skill; администрирование сети остаётся в полном MCP Worklife. Для клиента без нативных скиллов те же инструкции доступны через MCP.

Локальное приложение

uv run --env-file .env worklife --config config.toml app

Откройте http://127.0.0.1:8877. Интерфейс использует HeroUI 3, компоненты Magic UI, тёмное оформление в духе Apple/Codex, цветовую навигацию и системный шрифт с локальным Golos Text в резерве. Основное взаимодействие — в чате вашего MCP-агента; браузер показывает вызовы инструментов, результаты и настройки. Агент сам ведёт площадки, ресурсы, аккаунты, расписания и эксперименты. Приложение п