naukri-mcp

Un servidor MCP local para tu propia cuenta de Naukri.com: busca empleos, consulta detalles de empleos, guarda/solicita empleos, comprueba los empleos solicitados, lee tu perfil y lee los mensajes de los reclutadores — desde Claude Desktop (o cualquier cliente compatible con MCP). Construido sobre patchright (un Playwright con parches sigilosos) que controla un navegador Chromium real con un perfil persistente y con sesión iniciada, de modo que te autenticas una vez manualmente y todas las llamadas a herramientas posteriores reutilizan esa sesión sin interfaz gráfica.

No está afiliado a, respaldado por, ni soportado por Naukri.com / Info Edge (India) Ltd. "Naukri" es una marca comercial de su respectivo propietario, utilizada aquí solo para describir la interoperabilidad.

Lee esto antes de instalar

• Esto automatiza tu propia cuenta de Naukri, con tu propio inicio de sesión. No evita la autenticación ni accede a nada que no pudieras ver ya tú mismo — controla una sesión real del navegador como tú.

• Los Términos de Servicio de Naukri, como los de la mayoría de los sitios de empleo, restringen el acceso automatizado / mediante bots a las cuentas. Usar esto es una decisión personal sobre tu propia cuenta. Mantén un volumen de llamadas razonable — no hagas bucles con search_jobs, no solicites empleos en masa — para evitar activar defensas antibots o una revisión manual de la cuenta. Este proyecto no se hace responsable de las acciones realizadas con él; tú eres responsable de cómo lo usas y de cumplir con los términos de Naukri.

• Esto nunca ve ni maneja tu contraseña. naukri_login abre una ventana real y visible de Chrome y tú inicias sesión (incluyendo cualquier OTP) tú mismo; la herramienta solo observa la cookie de sesión que aparece después.

• Los selectores se desactualizarán. Naukri rediseña su marcado periódicamente, como cualquier sitio grande. extract.py prueba algunas variantes de selectores conocidas y recurre al texto bruto de la página en lugar de fallar, pero espera que ocasionalmente una PR arregle un selector roto después de un rediseño de Naukri. Confirmado que funciona de extremo a extremo (inicio de sesión + get_my_profile) según la versión en este repositorio — consulta el historial de commits / las versiones para ver qué se ha verificado desde entonces.

Related MCP server: LinkedIn MCP

Requisitos

• macOS o Linux, Python 3.10+

• Xcode Command Line Tools en macOS si aún no los tienes (xcode-select --install) — python3 -m venv los necesita

• ~200MB libres para la compilación de Chromium que descarga patchright

1. Instalación

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. Regístralo en tu cliente MCP

Para Claude Desktop, añade una entrada en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o la configuración equivalente en tu plataforma:

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

Obtén la ruta absoluta con which naukri-mcp (con el entorno virtual activado). Reinicia tu cliente MCP después para que detecte el nuevo servidor.

3. Primer inicio de sesión

Llama a la herramienta naukri_login. Se abre una ventana real y visible de Chrome en la página de inicio de sesión de Naukri; inicia sesión allí tú mismo (incluyendo cualquier OTP/captcha). La herramienta consulta durante hasta 5 minutos y guarda tu sesión en ~/.naukri-mcp/ una vez que detecta que has iniciado sesión. Después de eso, naukri_session_status informa logged_in: true y todas las demás herramientas se ejecutan sin interfaz gráfica.

Lista de herramientas

Naukri no tiene un equivalente real del gráfico social de LinkedIn (feed, conexiones, listas de empleados), así que esto no es un port 1:1 de un servidor MCP estilo LinkedIn — apply_to_job / get_applied_jobs / save_job / get_saved_jobs reflejan el valor principal real de Naukri (el propio proceso de solicitud de empleo) en su lugar.

Solución de problemas

ModuleNotFoundError: No module named 'mcp.server.fastmcp' — tienes mcp 2.x, que renombró ese módulo a mcp.server.mcpserver (MCPServer reemplaza a FastMCP, misma API .tool() / .run()). Este repositorio ya apunta a 2.x; si aún te encuentras con esto, comprueba pip show mcp.

Una herramienta devuelve raw_text o una note en lugar de datos estructurados — un selector no coincidió. Abre un issue con el fragmento de raw_text (redacta cualquier información personal) o envía una PR contra extract.py / tools_*.py.

Licencia

MIT — consulta LICENSE.