naukri-mcp

あなた自身のNaukri.comアカウントのためのローカルMCPサーバーです:求人検索、求人詳細の閲覧、求人の保存/応募、応募済み求人の確認、プロフィールの閲覧、リクルーターからのメッセージの閲覧を、Claude Desktop(またはMCP対応クライアント)から行えます。patchright(ステルスパッチ済みのPlaywright)をベースに、永続的なログイン済みプロファイルを持つ実際のChromiumブラウザを操作するため、一度手動で認証すれば、以後のすべてのツール呼び出しはそのセッションをヘッドレスで再利用します。

Naukri.com / Info Edge (India) Ltd. とは提携しておらず、承認も支援も受けていません。「Naukri」はそれぞれの権利者の商標であり、ここでは相互運用性を説明する場合にのみ使用しています。

インストール前にお読みください

• **これは、あなた自身のNaukriアカウントを、あなた自身のログインで自動操作するものです。**認証をバイパスしたり、あなた自身が見られない情報にアクセスしたりすることはありません。実際のブラウザセッションをあなたの代わりに操作しているだけです。

• **Naukriの利用規約は、他の多くの求人サイトと同様に、アカウントへの自動化/ボットアクセスを制限しています。**これを利用するかどうかは、あなた自身のアカウントに対する判断です。ボット対策や人によるアカウント審査を誘発しないよう、API呼び出しの量は適切に保ち、search_jobs をループさせたり、まとめて大量応募したりしないでください。このプロジェクトは、このツールを使って行われた行為について一切の責任を負いません。あなた自身の利用方法と、Naukriの規約の順守に責任を負うのはあなたです。

• このツールがあなたのパスワードを扱うことはなく、入力する際の目の前にも表示されません。naukri_login は実際に見える Chrome ウィンドウを開き、あなた自身でログイン(OTPを含む)します。ツールは、その後に表示されるセッションCookieを監視するだけです。

• **セレクタは陳腐化します。**Naukriは、大規模サイトの例に漏れず、定期的にマークアップを再設計します。extract.py は既知のセレクタのいくつかのバリエーションを試し、クラッシュする代わりにページの生テキストにフォールバックします。ただし、Naukriの再実装後には、壊れたセレクタを修正するPRが時折来ることが想定されます。このリポジトリのバージョン時点で、エンドツーエンド(ログイン+get_my_profile)の動作を確認済みです。以降に確認された事項はコミット履歴/リリースを参照して ください。

Related MCP server: LinkedIn MCP

必要条件

• macOSまたはLinux、Python 3.10以上

• macOSの場合、まだインストールしていなければXcode Command Line Tools(xcode-select --install) — python3 -m venv に必要

• patchright がダウンロードするChromiumビルド用に約200MBの空き容量

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": []
    }
  }
}

絶対パスは(vir3 naukri-mcp を使用して取得してください(venvを有効化した状態で)。その後、MCPクライアントを再起動して新しいサーバーを認識させてください。

3. 初回ログイン

naukri_login ツールを呼び出します。実際の表示される Chrome ウィンドウが Naukri のログインページで開きますので、そこでご自身でログインしてください(OTP/Captcha を含む)。ツールは最大5分間ポーリングし、ログインを検出するとセッションを~/.naukri-mcp/ に保存します。之後は、naukri_session_status が logged_in: true と表示し、それ以外のすべてのツールがヘッドレスで実行されます。

ツール一覧

Naukriには、LinkedInのようなソーシャルグラフ(フィード、コネクション、社員リスト)に相当するものがないため、これはLinkedIn風のMCPサーババーをそのまま移植(1:1)したものではありません。代わりに、ator 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 を置き換え、同じ .tool() / .run() API)、このエラーが発生することがあります。このリポジトリはすでに 2.x に対応していますが、もしこのエラーが出る場合は pip show mcp を確認してください。

A toolが構造化データの代わりに raw_text や note を返す場合 — セレクタが一致しなかった可能性があります。raw_text の一部(個人情報は編集して)を添えてIssueを開くか、extract.py / tools_*.py を対象としたPRを送ってください。

ライセンス

MIT — LICENSE を参照してください。