jobhunt_mcp

Персональный MCP-сервер, который превращает Claude в вашего операционного менеджера по поиску работы:

• Поиск актуальных вакансий на LinkedIn, Indeed, ZipRecruiter, Glassdoor (через JSearch API), а также на Adzuna

• Отслеживание каждого отклика в Google Sheets (статус, приоритет, заметки)

• Напоминания по расписанию — просроченные уведомления появляются автоматически

• Нетворкинг — храните контакты по компаниям и используйте их при подготовке

• Адаптация — один инструмент собирает описание вакансии + ваше мастер-резюме + контакты, чтобы Claude мог составить целевое резюме и сопроводительное письмо, сохраняемые прямо в Google Drive

По замыслу сервер никогда не отправляет отклики автоматически. Боты для автоматической отправки нарушают условия использования досок вакансий и попадают под блокировку. Инструмент prepare_application_package вместо этого доводит вас до шага «проверить и нажать отправить» за один шаг.

Предварительные требования

• Python 3.10+

• MCP-клиент — ниже предполагается Claude Desktop, но подойдёт любой MCP-совместимый клиент.

• Аккаунт Google (для трекера в Sheets и хранения резюме в Drive).

• (Необязательно) бесплатные аккаунты RapidAPI и/или Adzuna для поиска актуальных вакансий.

Настройка

Настройка включает: создание сервисного аккаунта Google, предоставление доступа к Sheet, папке Drive и резюме, (по желанию) получение ключей поисковых API, затем указание Claude Desktop на server.py. На шаги с Google заложите ~10 минут.

1. Сервисный аккаунт Google (~5 минут)

1. Перейдите на https://console.cloud.google.com → создайте проект (например, jobhunt).

2. Включите Google Sheets API и Google Drive API (APIs & Services → Library).

3. APIs & Services → Credentials → Create credentials → Service account. Подойдёт любое имя; дополнительные шаги можно пропустить.

4. Откройте сервисный аккаунт → Keys → Add key → JSON. Сохраните файл в надёжном месте, например ~/.config/jobhunt/service-account.json.

5. Скопируйте адрес электронной почты сервисного аккаунта (заканчивается на .iam.gserviceaccount.com) — далее вы будете предоставлять ему доступ.

2. Google Sheet (база данных трекера)

1. Создайте пустую Google Sheet с названием, например, «Job Hunt Tracker».

2. Предоставьте доступ сервисному аккаунту с ролью Редактор.

3. Скопируйте ID таблицы из URL: docs.google.com/spreadsheets/d/<ЭТА_ЧАСТЬ>/edit.

Сервер автоматически создаст вкладки Jobs, Contacts и Activity с заголовками при первом использовании.

3. Папка Google Drive + мастер-резюме

1. Создайте папку в Drive, например «Job Applications»; предоставьте доступ сервисному аккаунту с ролью Редактор. Скопируйте ID папки из URL.

2. Поместите мастер-резюме в Drive как Google Doc (версия со всеми вашими достижениями — адаптация сокращает её). Предоставьте доступ сервисному аккаунту. Скопируйте ID файла.

4. Ключи поисковых API (необязательно)

JSearch (рекомендуется — ищет по всем доскам сразу): бесплатно на https://rapidapi.com → найдите «JSearch» → подпишитесь на тариф Basic (бесплатный) → скопируйте ваш RapidAPI-ключ в RAPIDAPI_KEY.

Adzuna: бесплатно на https://developer.adzuna.com → зарегистрируйтесь → скопируйте ваш App ID и App Key в ADZUNA_APP_ID и ADZUNA_APP_KEY.

Пропустите эти шаги, если предпочитаете вставлять вакансии вручную с помощью jobhunt_add_job.

5. Установка и настройка

pip install -r requirements.txt

Скопируйте claude_desktop_config.example.json в конфигурацию Claude Desktop (claude_desktop_config.json), затем заполните путь к server.py в args, путь к GOOGLE_SERVICE_ACCOUNT_FILE, а также ID и ключи из шагов выше.

Расположение файлов конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json (используйте "python" для command и пути с двойными обратными слэшами, например C:\\Users\\you\\jobhunt-mcp\\server.py)

• Linux: ~/.config/Claude/claude_desktop_config.json

Перезапустите Claude Desktop (полностью завершите — в Windows/macOS проверьте трей/меню-бар). Инструменты jobhunt появятся после запуска сервера.

Переменные окружения

Всё настраивается через блок env в конфигурации Claude Desktop:

6. Проверка работы

Протестируйте сервер отдельно с помощью MCP Inspector в любое время (Claude Desktop не требуется):

npx @modelcontextprotocol/inspector python3 server.py

Затем попробуйте jobhunt_get_master_resume (подтверждает доступ к Drive) и jobhunt_list_jobs (подтверждает доступ к Sheets). Если оба вызова возвращаются без ошибки аутентификации — всё готово.

Инструменты

Примеры запросов для проверки

• «Найди на всех досках вакансии инженера по обнаружению SOC-инцидентов рядом с Далласом, опубликованные на этой неделе, и сохрани три лучших варианта.»

• «Подготовь пакет для отклика на вакансию a1b2c3d4, адаптируй моё резюме под неё и сохрани оба документа.»

• «Какие напоминания у меня просрочены?»

• «Я только что прошёл телефонное интервью с Acme — запиши это и напомни мне отправить благодарственное письмо завтра.»

Замечания по безопасности

• JSON-ключ сервисного аккаунта — это учётные данные; не храните его в git и в общих папках.

• Сервисный аккаунт может обращаться только к файлам, к которым вы явно предоставили доступ.

• Относитесь к описаниям вакансий, полученным из интернета, как к ненадёжному контенту; сервер хранит их как обычные данные.