naukri-mcp

一个本地 MCP 服务器，用于你自己的 Naukri.com 账户：搜索职位、查看职位详情、保存/申请职位、查看已申请职位、读取你的个人资料以及阅读招聘人员消息——可从 Claude Desktop（或任何兼容 MCP 的客户端）使用。基于 patchright（一个隐身补丁版的 Playwright）构建，驱动真实的 Chromium 浏览器，并使用持久化、已登录的配置文件，因此你只需手动认证一次，之后每次工具调用都会以无头模式复用该会话。

与 Naukri.com / Info Edge (India) Ltd. 无关联、未获其认可，也不受其支持。 "Naukri" 是其各自所有者的商标，此处仅用于描述互操作性。

安装前请阅读

• 这会自动化你自己的 Naukri 账户，使用你自己的登录状态。 它不会绕过身份验证，也不会访问任何你本来无法自行查看的内容——它只是以你的身份驱动一个真实的浏览器会话。

• 与大多数求职网站一样，Naukri 的服务条款限制对账户的自动化/机器人访问。 使用此工具需要你自行判断。保持合理的调用频率——不要循环调用 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 命令行工具（xcode-select --install）——python3 -m venv 需要它们

• 约 200MB 可用空间，用于 patchright 下载的 Chromium 构建

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/验证码）。该工具会轮询最多 5 分钟，一旦检测到您已登录，就会将会话保存到 ~/.naukri-mcp/。之后，naukri_session_status 会报告 logged_in: true，所有其他工具都会以无头模式运行。

工具列表

Naukri 没有真正等同于 LinkedIn 社交图谱（信息流、人脉、员工列表）的功能，因此这不是 LinkedIn 风格 MCP 服务器的 1:1 移植——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。

某个工具返回 raw_text 或 note 而不是结构化数据 — 说明某个选择器未匹配。请附上 raw_text 片段（请隐去任何个人信息）提交 issue，或针对 extract.py / tools_*.py 提交 PR。

许可证

MIT — 参见 LICENSE。