naukri-mcp

Локальный MCP сервер для вашего собственного аккаунта Naukri.com: поиск вакансий, просмотр деталей вакансий, сохранение/отклик на вакансии, проверка откликов, чтение вашего профиля и сообщений рекрутеров — из Claude Desktop (или любого MCP-совместимого клиента). Построен на patchright (стелс-патченный Playwright), который управляет реальным браузером Chromium с постоянным, залогиненным профилем, так что вы аутентифицируетесь один раз вручную, а каждый последующий вызов инструмента использует эту сессию в фоновом (headless) режиме.

Не аффилирован с Naukri.com / Info Edge (India) Ltd., не одобрен и не поддерживается ими. «Naukri» — товарный знак соответствующего владельца, используется здесь только для описания совместимости.

Прочтите это перед установкой

• Это автоматизирует ваш собственный аккаунт Naukri под вашим собственным логином. Он не обходит аутентификацию и не предоставляет доступ к тому, что вы не могли бы увидеть сами — он управляет реальной браузерной сессией от вашего имени.

• Условия обслуживания Naukri, как и большинства сайтов вакансий, ограничивают автоматический / бот-доступ к аккаунтам. Использование этого — ваше собственное решение относительно вашего аккаунта. Поддерживайте разумный объём вызовов — не зацикливайте search_jobs, не массово откликайтесь — чтобы не сработали антибот-защиты или ручная проверка аккаунта. Этот проект не несёт ответственности за действия, совершённые с его помощью; вы отвечаете за то, как вы его используете, и за соблюдение условий Naukri.

• Этот проект никогда не видит и не обрабатывает ваш пароль. naukri_login открывает реальное, видимое окно Chrome, и вы входите сами (включая любой OTP); инструмент только отслеживает появление сессионного cookie после этого.

• Селекторы будут устаревать. Naukri периодически меняет свою разметку, как и любой крупный сайт. extract.py пробует несколько известных вариантов селекторов и вместо падения возвращает сырой текст страницы, но ожидайте периодических PR для исправления сломанных селекторов после редизайна Naukri. Подтверждена работа end-to-end (логин + get_my_profile) на версии в этом репозитории — смотрите историю коммитов / релизы, чтобы узнать, что было проверено с тех пор.

Related MCP server: LinkedIn MCP

Требования

• macOS или Linux, Python 3.10+

• Xcode Command Line Tools на macOS, если у вас их ещё нет (xcode-select --install) — они нужны для python3 -m venv

• ~200 МБ свободного места для сборки Chromium, которую загружает patchright

1. Установка

git clone https://github.com/<you>/naukri-mcp.git
cd naukri-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip   # old pip can't do editable installs from pyproject.toml alone
pip install -e .
python3 -m patchright install chromium

2. Зарегистрируйте его в вашем MCP-клиенте

Для Claude Desktop добавьте запись в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или в аналогичный конфиг на вашей платформе:

{
  "mcpServers": {
    "naukri": {
      "command": "/absolute/path/to/naukri-mcp/.venv/bin/naukri-mcp",
      "args": []
    }
  }
}

Получите абсолютный путь с помощью which naukri-mcp (при активированном venv). После этого перезапустите ваш MCP-клиент, чтобы он подхватил новый сервер.

3. Первый вход

Вызовите инструмент naukri_login. Откроется реальное, видимое окно Chrome на странице входа Naukri; войдите там сами (включая любой OTP/captcha). Инструмент опрашивает до 5 минут и сохраняет вашу сессию в ~/.naukri-mcp/, как только обнаружит, что вы вошли. После этого naukri_session_status сообщает logged_in: true, и все остальные инструменты работают в фоновом (headless) режиме.

Список инструментов

У Naukri нет реального аналога социального графа LinkedIn (лента, контакты, списки сотрудников), так что это не порт 1:1 MCP-сервера в стиле LinkedIn — вместо этого apply_to_job / get_applied_jobs / save_job / get_saved_jobs отражают реальную основную ценность Naukri (сам конвейер вакансий).

Устранение неполадок

ModuleNotFoundError: No module named 'mcp.server.fastmcp' — у вас установлен mcp 2.x, в котором этот модуль переименован в mcp.server.mcpserver (MCPServer заменяет FastMCP, тот же API .tool() / .run()). Этот репозиторий уже нацелен на 2.x; если вы всё ещё сталкиваетесь с этим, проверьте pip show mcp.

Инструмент возвращает raw_text или note вместо структурированных данных — селектор не совпал. Откройте issue с фрагментом raw_text (удалите личные данные) или отправьте PR против extract.py / tools_*.py.

Лицензия

MIT — см. LICENSE.