Skip to content
Back to search

boss-zhipin-mcp

BOSS直聘 MCP Server — 用 AI 自动化招聘流程:批量搜索候选人、简历截图OCR、智能评估、多关键词筛选 | BOSS Zhipin Recruiter Automation via Model Context Protocol

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/snseam--boss-zhipin-mcp/badge.svg)](/listings/snseam--boss-zhipin-mcp)

HTML

<a href="/listings/snseam--boss-zhipin-mcp"><img src="/api/listings/snseam--boss-zhipin-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 280 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # BOSS 直聘 MCP Server
  2. > 用 AI 自动化 BOSS 直聘招聘流程 — 批量搜索、自动获取链接、智能筛选评分、一键导出报告
  3. [![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
  4. [![Python](https://img.shields.io/badge/Python-3.12+-green)](https://python.org)
  5. [![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
  6. **BOSS 直聘 (zhipin.com)** 招聘者端自动化工具,基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io),让 Claude Code / Claude Desktop 等 AI 助手直接操作 BOSS 直聘招聘后台。
  7. ## 功能特性
  8. - **候选人搜索** — 在 BOSS 直聘「找人才」页面搜索,支持滚动加载 100+ 候选人
  9. - **多关键词批量搜索** — 12+ 关键词自动轮询 + 跨关键词去重 + **每个关键词搜索后自动获取分享链接**
  10. - **候选人数据库** — 搜索结果自动持久化到本地 JSON 数据库,中断可恢复,数据不丢失
  11. - **简历查看** — 点击候选人卡片,自动截图 Canvas 渲染的简历(绕过防爬)
  12. - **分享链接提取** — 自动点击转发按钮,解码 QR 码获取 `zpurl.cn` 永久链接
  13. - **一键打招呼** — 在搜索结果中直接对候选人发起沟通,进入 BOSS 聊天列表
  14. - **自动筛选评分** — 按 YAML 配置的条件(年龄/薪资/状态)过滤 + 多维度评分
  15. - **报告导出** — 一键生成 Markdown 候选人报告(表格 + 跟进表 + 详情卡片)
  16. - **浏览器自动启动** — 未检测到 Chrome debug 端口时,自动启动系统 Chrome
  17. - **YAML 配置** — 公司信息、JD、搜索关键词、筛选条件全部可配置
  18. ## 工作原理
  19. ```
  20. Claude Code / Claude Desktop
  21. ↓ MCP (stdio)
  22. boss-zhipin-mcp (FastMCP Server)
  23. ↓ CDP (Chrome DevTools Protocol)
  24. Chrome 浏览器 (已登录 BOSS 直聘)
  25. ↓
  26. BOSS 直聘招聘者后台 (zhipin.com)
  27. ```
  28. 通过 Playwright 连接你已登录的 Chrome 浏览器,在 BOSS 直聘的 SPA 页面内操作搜索、查看、发消息等功能。
  29. ## 完整招聘流水线
  30. ```
  31. boss_multi_search(auto_view=True)
  32. │
  33. │ ┌─── 关键词循环 (12次) ────────────────────────┐
  34. │ │ 1. 搜索关键词 → 页面加载候选人卡片 │
  35. │ │ 2. 去重 + 存入数据库 │
  36. │ │ 3. 全量 view 所有新候选人 → 获取 share_url │
  37. │ │ 4. 切换下一个关键词 │
  38. │ └──────────────────────────────────────────────┘
  39. │ 结果: 所有候选人有 share_url + 完整数据在 DB
  40. ▼
  41. boss_filter_and_score(top_n=15) ← 自动筛选+评分
  42. ▼
  43. boss_export_report(top_n=15) ← 生成 Markdown 报告
  44. ▼
  45. boss_greet_by_index() / boss_send_greeting() ← 联系候选人
  46. ```
  47. ## 快速开始
  48. ### 1. 安装
  49. ```bash
  50. git clone https://github.com/Snseam/boss-zhipin-mcp.git
  51. cd boss-zhipin-mcp
  52. python -m venv .venv
  53. source .venv/bin/activate
  54. pip install -r requirements.txt
  55. playwright install chromium
  56. ```
  57. ### 2. 配置搜索条件
  58. ```bash
  59. cp search_profile.example.yaml search_profile.yaml
  60. ```
  61. 编辑 `search_profile.yaml`,填入你的岗位信息和搜索关键词:
  62. ```yaml
  63. job:
  64. title: "AI 产品经理"
  65. salary: "20-30K"
  66. city: "北京"
  67. keywords:
  68. - "AI产品经理"
  69. - "AIGC产品经理"
  70. - "大模型 产品"
  71. filter:
  72. max_age: 35
  73. max_salary_k: 40
  74. exclude_status: ["暂不考虑"]
  75. scoring:
  76. domain_keywords: ["教育", "学术", "科研"]
  77. tech_keywords: ["大模型", "llm", "rag", "agent"]
  78. ```
  79. ### 3. 启动 Chrome(可选,MCP 会自动启动)
  80. ```bash
  81. # macOS — MCP 未检测到 debug 端口时会自动启动系统 Chrome
  82. # 如需手动启动:
  83. "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222
  84. ```
  85. 在浏览器中打开 [zhipin.com](https://www.zhipin.com) 并登录你的招聘者账号。
  86. ### 4. 连接 Claude Code
  87. 在项目根目录创建 `.mcp.json`:
  88. ```json
  89. {
  90. "mcpServers": {
  91. "boss-recruiter": {
  92. "command": "/path/to/boss-zhipin-mcp/.venv/bin/python",
  93. "args": ["/path/to/boss-zhipin-mcp/server.py"],
  94. "env": {
  95. "NO_PROXY": "localhost,127.0.0.1"
  96. }
  97. }
  98. }
  99. }
  100. ```
  101. ### 5. 开始使用
  102. ```
  103. 你: 帮我搜索北京的 AI 产品经理
  104. Claude: boss_multi_search(auto_view=True)
  105. → 12 关键词搜索,537 新候选人,全部获取 share_url
  106. → boss_filter_and_score(top_n=15)
  107. → boss_export_report(top_n=15)
  108. → 生成候选人报告文档
  109. ```
  110. ## MCP Tools
  111. ### 搜索与查看
  112. | Tool | 说明 |
  113. | ------------------------ | ------------------------------------------------------------------ |
  114. | `boss_login` | 登录 BOSS 直聘(检查 Cookie,失效则等待手动登录) |
  115. | `boss_search_candidates` | 单关键词搜索候选人(支持滚动加载、自动去重、自动存入数据库) |
  116. | `boss_multi_search` | **多关键词批量搜索**(自动去重 + 自动 view 获取链接,`auto_view`) |
  117. | `boss_view_by_index` | 点击候选人查看简历(截图 + 提取分享链接 + 自动存入数据库) |
  118. | `boss_view_by_expect_id` | 通过 expectId 在当前页面查找并查看候选人 |
  119. | `boss_greet_by_index` | 在搜索结果中直接打招呼(候选人进入沟通列表) |
  120. | `boss_send_greeting` | 向候选人发送打招呼消息(通过 URL) |
  121. ### 数据库与筛选
  122. | Tool | 说明 |
  123. | ----------------------- | ----------------------------------------------------------------- |
  124. | `boss_query_db` | 查询候选人数据库(按状态/链接/关键词/日期筛选,无需浏览器) |
  125. | `boss_update_candidate` | 更新候选人状态/评分/备注 |
  126. | `boss_filter_and_score` | **自动筛选+评分**(按 YAML 条件过滤,多维度评分,Top N 标记入库) |
  127. | `boss_export_report` | **导出 Markdown 报告**(表格 + 跟进表 + 详情卡片) |
  128. | `boss_pipeline_status` | 查看招聘流水线进度(统计 + 恢复建议) |
  129. | `boss_clear_dedup` | **选择性**清除去重记录(按 ID/状态/日期,或全量清除) |
  130. ### 工具
  131. | Tool | 说明 |
  132. | ------------------------- | -------------------------------------------------- |
  133. | `boss_evaluate_candidate` | 简易关键词匹配评估(建议直接在 Claude 对话中评估) |
  134. | `boss_reload` | 热重载代码,修改后无需重启 server |
  135. | `boss_debug_page` | 调试工具,扫描当前页面 DOM 结构 |
  136. ## 候选人数据库
  137. 搜索结果自动持久化到 `candidates_db.json`,不再丢失数据:
  138. ```json
  139. {
  140. "candidates": {
  141. "<expectId>": {
  142. "name": "张**",
  143. "age": "27岁",
  144. "salary": "20-25K",
  145. "company": "某公司",
  146. "school": "某大学",
  147. "fullText": "...",
  148. "share_url": "https://zpurl.cn/...",
  149. "status": "shortlisted",
  150. "score": 95,
  151. "first_seen": "2026-03-30"
  152. }
  153. }
  154. }
  155. ```
  156. **状态流转**: `new` → `shortlisted`(评分后)→ `viewed`(获取链接后)→ `greeted`(打招呼后)
  157. **中断恢复**: 任意步骤中断后,`boss_pipeline_status()` 显示进度和恢复建议。
  158. ## 搜索配置
  159. `search_profile.yaml` 支持完整的搜索策略配置:
  160. ```yaml
  161. job:
  162. title: "岗位名称"
  163. salary: "薪资范围"
  164. city: "城市"
  165. experience: "经验要求"
  166. company:
  167. name: "公司名"
  168. description: "公司简介"
  169. requirements:
  170. must_have: [...] # 硬性要求
  171. nice_to_have: [...] # 加分项
  172. filter:
  173. max_age: 35 # 年龄上限
  174. max_salary_k: 40 # 薪资上限(K)
  175. exclude_status: ["暂不考虑"]
  176. keywords: # 搜索关键词列表
  177. - "关键词1"
  178. - "关键词2"
  179. scoring: # 评分关键词
  180. domain_keywords: ["教育", "学术"]
  181. tech_keywords: ["大模型", "llm", "rag"]
  182. bonus_keywords: ["0-1", "从0到1"]
  183. ```
  184. ## 技术细节
  185. - **浏览器连接**:CDP → 已登录 Chrome。未检测到 debug 端口时自动启动系统 Chrome
  186. - **SPA 适配**:搜索页在 iframe 中渲染,自动导航到招聘者后台
  187. - **Canvas 简历**:截图 + QR 码解码获取永久链接
  188. - **候选人数据库**:JSON 文件,原子写入,基于 `expectId` 去重
  189. - **反检测**:随机延迟(2-5s)模拟人类操作节奏
  190. ## 项目结构
  191. ```
  192. boss-zhipin-mcp/
  193. ├── server.py # MCP Server 入口,注册所有 tools
  194. ├── scraper.py # BOSS 直聘页面抓取(SPA + iframe)
  195. ├── browser.py # Playwright CDP 浏览器管理 + 自动启动 Chrome
  196. ├── candidate_db.py # 候选人数据库(持久化 + 去重 + 查询)
  197. ├── evaluator.py # 候选人评估(关键词匹配)
  198. ├── config.py # 配置加载
  199. ├── search_profile.example.yaml # 搜索配置示例
  200. ├── candidates_db.json # 候选人数据库文件(自动生成)
  201. ├── requirements.txt
  202. └── README.md
  203. ```
  204. ## 常见问题
  205. ### 连接失败 `Unexpected status 400`
  206. 系统有代理(如 Clash),localhost 请求被代理拦截。在 MCP 配置中添加:
  207. ```json
  208. "env": { "NO_PROXY": "localhost,127.0.0.1" }
  209. ```
  210. ### 搜索返回空结果
  211. 1. 确认 Chrome 已登录 BOSS 直聘招聘者账号
  212. 2. 确认 Chrome 启动时带了 `--remote-debugging-port=9222`(或让 MCP 自动启动)
  213. 3. 检查 `curl http://localhost:9222/json/version` 是否有响应
  214. ### 简历内容为空
  215. BOSS 直聘用 Canvas 渲染简历,无法直接提取文字。使用 `boss_view_by_index` 截图后,让 Claude 直接看图识别。
  216. ## License
  217. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.