SB

snseam/boss-zhipin-mcp

Browser automation

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

158 stars 29 forks 품질 62 트렌드 17

snseam/boss-zhipin-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

snseam/boss-zhipin-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

AI 자동화 BOSS 직聘招聘流程 — 批量搜索、자동 获取链接、智能筛选评分、한 键导出报告

BOSS 直聘 (zhipin.com) 招聘者端自动化工具,基于 Model Context Protocol (MCP),让 Claude Code / Claude Desktop 等 AI 助手直接操作 BOSS 直聘招聘后台。

功能特性

  • 候选人搜索 — 在 BOSS 直聘「找人才」页面搜索,支持滚动加载 100+ 候选人
  • 多关键词批量搜索 — 12+ 关键词自动轮询 + 跨关键词去重 + 每个关键词搜索后自动获取分享链接
  • 候选人데이터베이스 — 搜索결과, 자동 지속화到本地 JSON 데이터베이스,중단可恢复,数据不丢失
  • 简历查看 — 点击候选人卡片,自动截图 Canvas 渲染的简历(绕过防爬)
  • 分享链接提取 — 자동 点击转发按钮,解码 QR 码获取 zpurl.cn 永久链接
  • 一键打招呼 — 在搜索结果中直接对候选人发起沟通,进入 BOSS 聊天列表
  • 자동 筛选评分 — 按 YAML 配置的条件(年龄/薪资/状态)过滤 + 多维度评分
  • 报告导出 — 一键生成 Markdown 候选人报告(表格 + 跟进表 + 详情카드)
  • 브라우저 자동 启动 — 未检测到 Chrome debug 端口时,自动启动系统 Chrome
  • YAML 配置 — 회사信息、JD、搜索关键词、筛选条件全部可配置

工作原理

通过 Playwright 连接你已登录的 Chrome 浏览器,在 BOSS 直聘的 SPA 页面内操作搜索、查看、发消息等功能。

完整招聘流水线

快速开始

1. 安装

2. 配置搜索条件

编辑 search_profile.yaml,填入你的岗位信息和搜索关键词:

3. 启动 Chrome(可选,MCP 会自动启动)

在浏览器中打开 zhipin.com 并登录당신의 招聘者账号。

4. 连接 Claude 코드

在项目根目录创建 .mcp.json:

5. 开始使用

MCP 도구

搜索与查看

도구 说明
boss_login 登录 BOSS 直聘(检查 Cookie,失效则等待手动登录)

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

BOSS 直聘 MCP Server

用 AI 自动化 BOSS 直聘招聘流程 — 批量搜索、自动获取链接、智能筛选评分、一键导出报告

BOSS 直聘 (zhipin.com) 招聘者端自动化工具,基于 Model Context Protocol (MCP),让 Claude Code / Claude Desktop 等 AI 助手直接操作 BOSS 直聘招聘后台。

功能特性

  • 候选人搜索 — 在 BOSS 直聘「找人才」页面搜索,支持滚动加载 100+ 候选人
  • 多关键词批量搜索 — 12+ 关键词自动轮询 + 跨关键词去重 + 每个关键词搜索后自动获取分享链接
  • 候选人数据库 — 搜索结果自动持久化到本地 JSON 数据库,中断可恢复,数据不丢失
  • 简历查看 — 点击候选人卡片,自动截图 Canvas 渲染的简历(绕过防爬)
  • 分享链接提取 — 自动点击转发按钮,解码 QR 码获取 zpurl.cn 永久链接
  • 一键打招呼 — 在搜索结果中直接对候选人发起沟通,进入 BOSS 聊天列表
  • 自动筛选评分 — 按 YAML 配置的条件(年龄/薪资/状态)过滤 + 多维度评分
  • 报告导出 — 一键生成 Markdown 候选人报告(表格 + 跟进表 + 详情卡片)
  • 浏览器自动启动 — 未检测到 Chrome debug 端口时,自动启动系统 Chrome
  • YAML 配置 — 公司信息、JD、搜索关键词、筛选条件全部可配置

工作原理

Claude Code / Claude Desktop
    ↓ MCP (stdio)
boss-zhipin-mcp (FastMCP Server)
    ↓ CDP (Chrome DevTools Protocol)
Chrome 浏览器 (已登录 BOSS 直聘)
    ↓
BOSS 直聘招聘者后台 (zhipin.com)

通过 Playwright 连接你已登录的 Chrome 浏览器,在 BOSS 直聘的 SPA 页面内操作搜索、查看、发消息等功能。

完整招聘流水线

boss_multi_search(auto_view=True)
│
│  ┌─── 关键词循环 (12次) ────────────────────────┐
│  │  1. 搜索关键词 → 页面加载候选人卡片           │
│  │  2. 去重 + 存入数据库                         │
│  │  3. 全量 view 所有新候选人 → 获取 share_url   │
│  │  4. 切换下一个关键词                          │
│  └──────────────────────────────────────────────┘
│  结果: 所有候选人有 share_url + 完整数据在 DB
▼
boss_filter_and_score(top_n=15)     ← 自动筛选+评分
▼
boss_export_report(top_n=15)        ← 生成 Markdown 报告
▼
boss_greet_by_index() / boss_send_greeting()  ← 联系候选人

快速开始

1. 安装

git clone https://github.com/Snseam/boss-zhipin-mcp.git
cd boss-zhipin-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
playwright install chromium

2. 配置搜索条件

cp search_profile.example.yaml search_profile.yaml

编辑 search_profile.yaml,填入你的岗位信息和搜索关键词:

job:
  title: "AI 产品经理"
  salary: "20-30K"
  city: "北京"

keywords:
  - "AI产品经理"
  - "AIGC产品经理"
  - "大模型 产品"

filter:
  max_age: 35
  max_salary_k: 40
  exclude_status: ["暂不考虑"]

scoring:
  domain_keywords: ["教育", "学术", "科研"]
  tech_keywords: ["大模型", "llm", "rag", "agent"]

3. 启动 Chrome(可选,MCP 会自动启动)

# macOS — MCP 未检测到 debug 端口时会自动启动系统 Chrome
# 如需手动启动:
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222

在浏览器中打开 zhipin.com 并登录你的招聘者账号。

4. 连接 Claude Code

在项目根目录创建 .mcp.json:

{
  "mcpServers": {
    "boss-recruiter": {
      "command": "/path/to/boss-zhipin-mcp/.venv/bin/python",
      "args": ["/path/to/boss-zhipin-mcp/server.py"],
      "env": {
        "NO_PROXY": "localhost,127.0.0.1"
      }
    }
  }
}

5. 开始使用

你: 帮我搜索北京的 AI 产品经理
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "boss-recruiter": { "command": "/path/to/boss-zhipin-mcp/.venv/bin/python", "args": ["/path/to/boss-zhipin-mcp/server.py"], "env": { "NO_PROXY": "localhost,127.0.0.1" } } } }