naukri-mcp

Ein lokaler MCP-Server für dein eigenes Naukri.com-Konto: Jobs suchen, Jobdetails ansehen, Jobs speichern/bewerben, beworbene Jobs prüfen, dein Profil lesen und Recruiter-Nachrichten lesen — von Claude Desktop (oder jedem MCP-kompatiblen Client). Basierend auf patchright (ein stealth-gepatchtes Playwright), das einen echten Chromium-Browser mit einem persistenten, eingeloggten Profil steuert — du authentifizierst dich also einmal manuell und jeder Tool-Aufruf danach nutzt diese Sitzung headless.

Nicht verbunden mit, befürwortet von oder unterstützt durch Naukri.com / Info Edge (India) Ltd. „Naukri" ist eine Marke des jeweiligen Inhabers, die hier nur zur Beschreibung der Interoperabilität verwendet wird.

Lies das, bevor du installierst

• Das automatisiert dein eigenes Naukri-Konto unter deinem eigenen Login. Es umgeht keine Authentifizierung und greift auf nichts zu, was du nicht ohnehin selbst sehen könntest — es steuert eine echte Browser-Sitzung als du.

• Naukris Nutzungsbedingungen, wie bei den meisten Jobseiten, schränken automatisierten / Bot-Zugriff auf Konten ein. Die Nutzung ist eine Ermessensentscheidung bezüglich deines eigenen Kontos. Halte die Aufrufhäufigkeit angemessen — loop nicht search_jobs, bewirb dich nicht massenhaft — um Anti-Bot-Abwehr oder eine manuelle Kontoprüfung zu vermeiden. Dieses Projekt übernimmt keine Verantwortung für Handlungen, die damit ausgeführt werden; du bist verantwortlich für die Art der Nutzung und für die Einhaltung von Naukris Bedingungen.

• Dieses Tool sieht oder verarbeitet niemals dein Passwort. naukri_login öffnet ein echtes, sichtbares Chrome-Fenster und du loggst dich selbst ein (einschließlich etwaiger OTP); das Tool wartet nur auf das Session-Cookie, das danach erscheint.

• Selektoren werden sich ändern. Naukri gestaltet sein Markup regelmäßig neu, wie jede große Website. extract.py versucht ein paar bekannte Selektor-Varianten und fällt auf rohen Seitentext zurück, anstatt abzustürzen, aber erwarte gelegentliche PRs, um einen defekten Selektor nach einem Naukri-Redesign zu reparieren. End-to-End bestätigt funktionierend (Login + get_my_profile) ab der Version in diesem Repo — siehe Commit-Historie / Releases für das, was seitdem verifiziert wurde.

Related MCP server: LinkedIn MCP

Voraussetzungen

• macOS oder Linux, Python 3.10+

• Xcode Command Line Tools auf macOS, falls du sie nicht bereits hast (xcode-select --install) — python3 -m venv benötigt sie

• ~200 MB freier Speicher für den Chromium-Build, den patchright herunterlädt

1. Installieren

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. Bei deinem MCP-Client registrieren

Für Claude Desktop füge einen Eintrag in ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder die entsprechende Konfiguration auf deiner Plattform hinzu:

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

Hole den absoluten Pfad mit which naukri-mcp (venv aktiviert). Starte deinen MCP-Client danach neu, damit er den neuen Server erkennt.

3. Erster Login

Rufe das Tool naukri_login auf. Ein echtes, sichtbares Chrome-Fenster öffnet sich auf Naukris Login-Seite; logge dich dort selbst ein (einschließlich etwaiger OTP/Captcha). Das Tool pollt bis zu 5 Minuten und speichert deine Sitzung in ~/.naukri-mcp/, sobald es erkennt, dass du eingeloggt bist. Danach meldet naukri_session_status logged_in: true und jedes andere Tool läuft headless.

Tool-Liste

Naukri hat kein echtes Äquivalent zu LinkedIns sozialem Graphen (Feed, Verbindungen, Mitarbeiterlisten), daher ist dies keine 1:1-Portierung eines LinkedIn-artigen MCP-Servers — apply_to_job / get_applied_jobs / save_job / get_saved_jobs spiegeln stattdessen Naukris eigentlichen Kernwert wider (die Job-Pipeline selbst).

Fehlerbehebung

ModuleNotFoundError: No module named 'mcp.server.fastmcp' — du hast mcp 2.x, das dieses Modul in mcp.server.mcpserver umbenannt hat (MCPServer ersetzt FastMCP, gleiche .tool() / .run()-API). Dieses Repo zielt bereits auf 2.x; falls du das immer noch triffst, prüfe pip show mcp.

Ein Tool gibt raw_text oder note statt strukturierter Daten zurück — ein Selektor hat nicht gepasst. Öffne ein Issue mit dem raw_text-Ausschnitt (entferne persönliche Daten) oder sende einen PR gegen extract.py / tools_*.py.

Lizenz

MIT — siehe LICENSE.