# Boss Zhipin Scraper

> 引导用户提供简历和求职偏好，通过 BOSS-Agent 专用 Chrome Profile 与 macOS Computer Use 在 BOSS直聘官方可见页面搜索岗位、读取完整 JD、去重、校准市场要求、评分并生成 A/B/C 触达档位；校准后询问目标招呼数（默认建议 20 个），仅在用户确认具体批次、档位、数量和招呼模式后持续搜索并触达达标岗位。用于“找工作”“搜岗位”“看 JD”“分析 BOSS 职位”“筛选职位”“持续打招呼”等个人求职任务。禁止 CLI、CDP、Playwright、隐藏 API、Cookie 提取和反检测路线。

- Skill: `backtthefuture/boss-zhipin-scraper` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add backtthefuture/boss-zhipin-scraper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/backtthefuture/boss-zhipin-scraper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: backtthefuture (https://skillmd.com/u/backtthefuture)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/backtthefuture/boss-zhipin-scraper

---


# BOSS直聘个人求职工作流

把任务作为有确认门的状态机运行：

```text
ONBOARD → PROFILE → PREFERENCES → SEARCH_CONFIRM → LOGIN_CHECK
→ CALIBRATE → RECOMMEND_TIERS → OUTREACH_CONFIRM → EXECUTE_LOOP → REVIEW
```

不得跳过当前状态的必需输入或确认。用户已提供的信息直接继承，不重复询问。

## 强制边界

- 仅用于用户本人求职。
- 只操作窗口标题带 `BOSS-Agent` 的专用 Chrome Profile，通过 macOS Computer Use 执行官方页面可见交互。
- 禁止 BOSS CLI、CDP、远程调试、Bridge、Patchright、Playwright、无头浏览器、隐藏 API、`/wapi`、XHR/fetch 注入、Cookie 或 stoken 提取、代理轮换、指纹伪装和验证码绕过。
- 运行规则只以本文件及其直接引用的 `references/` 为准；不得重新引入旧 CLI、CDP、脚本依赖或虚拟环境路线。
- 登录、扫码和验证码由用户手动完成。不得读取、代填或保存验证码和认证信息。
- 搜索与校准默认只读。未通过 `OUTREACH_CONFIRM` 前，不得收藏、投递、打招呼、交换联系方式或修改账号状态。
- 自动打招呼不包含自动投递、交换联系方式、修改在线简历、求职期望、隐私或账号设置。
- 用户启动 Goal、说“开始搜索”或确认搜索卡，都不等于授权发送消息。

## 状态机

### 1. ONBOARD：首次引导

先引导用户上传简历；支持图片、PDF、Word或粘贴文字。没有正式简历时，引导用户提供工作年限、最近岗位、主要项目、技能和学历。

只提取岗位匹配信息；姓名、手机号、邮箱等无关隐私不得主动回显或写入报告。未在简历中出现的能力写“未体现”，不得推断为具备。

完整话术、字段和无简历路径见 [references/onboarding-profile.md](references/onboarding-profile.md)。

### 2. PROFILE：回显简历画像

回显工作年限、岗位/行业、产品类型、项目证据、量化结果、技能、学历、可迁移能力和未体现项。让用户纠正事实，但不要要求其重复简历已有内容。

### 3. PREFERENCES：两轮补齐偏好

每轮最多问 3 个会改变搜索结果的问题：

1. 第一轮：目标岗位或参考 JD、城市/远程、最低薪资；
2. 第二轮：JD 经验上限、必须排除项、可选公司/行业/通勤偏好。

已明确字段跳过；参考 JD 是选填项，不作为启动前提。

### 4. SEARCH_CONFIRM：搜索确认门

生成搜索确认卡，至少包含：简历画像、城市、岗位、检索词、薪资、经验上限、职位类型、必须排除、排序偏好、校准样本规模和本阶段“零消息”。

只有用户确认搜索卡或明确确认同等内容后，才能操作 BOSS 页面。搜索确认仅授权只读校准。

### 5. LOGIN_CHECK：连接专用浏览器

1. 连接可见的普通 Chrome，只操作 `BOSS-Agent` Profile；请用户将其置顶。
2. 优先复用其中的 `https://www.zhipin.com/` 标签页，不操作其他 Profile。
3. 只读检查域名、登录标志和安全验证，不为测试额外提交搜索。
4. 未登录时停下，请用户手动登录；用户说“已登录”后重新检查。
5. 每次页面动作后重新读取最新 UI 状态，禁止复用过期元素索引。

### 6. CALIBRATE：只读市场校准

- 默认读取 15–30 张职位卡片，并从中选择约 10 条代表性完整 JD。
- 先读列表、历史去重和硬条件预筛，再打开尚未完整读取且可能有分析价值的 JD。
- 样本覆盖高匹配、边缘、薪资高但要求高、垂直行业、疑似销售/外派和列表与 JD 冲突等类型。
- 本阶段外部动作数必须为 `0`；不得打招呼、收藏或投递。
- 完整 JD 优先于列表标签；字段缺失写“页面未展示/待核验”。
- 校准样本只用于确定市场要求、评分阈值和搜索方向，与后续目标招呼数无关。不得把样本中的达标岗位数当作触达批次上限。

详细校准、评分和样本选择见 [references/calibration-tiering.md](references/calibration-tiering.md)。

### 7. RECOMMEND_TIERS：给出动态档位

根据本批真实 JD 与用户简历输出：市场画像、已有证据、可迁移能力、硬性缺口、推荐搜索方向，以及 A精准/B平衡/C机会三档。

档位不能只看总分；必须同时通过：

1. 用户硬条件；
2. 档位总分门槛；
3. 岗位方向、简历技能、经验等核心维度门槛；
4. 风险否决项。

阈值由本批样本动态建议；默认参考为 A≥85、B≥80、C≥72，但不得在校准前强行套用。

### 8. OUTREACH_CONFIRM：触达确认门

在发送第一条消息前，必须回显并让用户确认：

- 本批搜索范围和档位；
- 本批目标招呼数；未指定时主动询问，默认建议 `20` 个，不得静默代填；
- 自动触达的硬条件、核心分门槛和风险否决项；
- 边缘岗位如何处理；
- 招呼模式：平台默认招呼语，或自定义模板及允许的个性化范围；
- 明确禁止的投递、联系方式和账号修改动作；
- 授权只对本批有效。

含糊表达如“看着办”“你决定”“开始搜索”不构成触达授权。完整确认卡和模板规则见 [references/outreach-authorization.md](references/outreach-authorization.md)。

### 9. EXECUTE_LOOP：持续搜索、逐岗判断与触达

触达目标以本批 `target_outreach_count` 为准，不以校准样本量、当前结果页数量或首批达标岗位数为准。只要尚未达到目标且未触发真实硬停止，就继续搜索已确认范围内的新岗位。

每个岗位严格串行执行：

```text
读列表 → 查历史台账 → 读完整 JD → 硬条件过滤
→ 逐项评分 → 风险检查 → 档位判断 → 触达或归档 → 写检查点
```

- 达到用户所选档位且无否决项：发送已批准骨架的轻度个性化招呼。
- 用户批准“平台默认招呼语”时，允许点击“立即沟通”触发平台内置招呼语；发送后记录页面展示的实际文案。不得把平台默认文案改写成简历事实。
- 接近门槛或有一项待核验：进入待确认名单，不发送。
- 命中硬性排除、信息不足或未读完整 JD：不发送。
- 已沟通、已发送或历史状态不明：不重复发送，必要时待确认。
- 消息只能使用简历中有证据的经历；不得虚构 AI、Agent、RAG、大模型或行业经验。
- 用户调整规则后只影响后续岗位，不追溯重发。
- `target_outreach_count` 与 `outreach_sent` 只统计“确认发送成功的唯一岗位数”。同一岗位的补发消息不重复计数；`unknown`、失败、已沟通、重复岗位和跳过岗位不计入目标。
- 每次点击“立即沟通”后，严格执行事务顺序：重新读取 UI → 确认发送结果 → 写岗位台账 → 更新批次计数 → 写触达审计。以上写入全部成功前，不得读取或触达下一个岗位。
- 页面明确显示“已向BOSS发送消息”或聊天记录显示已送达，才把该唯一岗位计入 `outreach_sent`，并更新 `remaining_outreach_count`。当 `outreach_sent >= target_outreach_count` 才正常结束触达批次。
- 任一检查点写入失败时停止后续外部动作，保留当前页面，修复台账后再继续；不得先发下一条再批量补记。
- 当前关键词或结果页没有更多达标岗位时，切换到确认卡内的下一个检索词或结果页继续；不得因为校准样本已处理完而提前结束。

### 10. REVIEW：批次复盘

汇报列表卡片、唯一岗位、重复跳过、完整 JD、自动触达、待确认、排除、失败、风控和累计数据；给出本批最常见优势、缺口及是否建议调档。

台账字段、检查点和验收案例见 [references/ledger-acceptance.md](references/ledger-acceptance.md)。

## 瞬时 UI 状态恢复

Computer Use 返回 `The user changed '/Applications/Google Chrome.app'`、`Computer Use is not active` 或类似“状态已变化/需要重新读取”的提示时，不得仅凭该提示认定用户接管，也不得立即标记 `partial`。

按以下顺序恢复：

1. 立即调用 `get_app_state` 获取全量最新状态；这属于状态重连，不算自动重试页面动作。
2. 核验窗口仍为 `BOSS-Agent`、域名仍为 `zhipin.com`、登录标志存在、当前页面符合预期且无安全验证。
3. 若上一步动作结果可能已经生效，先从最新页面、聊天记录或“已向BOSS发送消息”提示确认结果；结果未确认前不得重复点击。
4. 状态正常则从当前步骤继续，不要求用户重新说“继续”，也不新开批次。

恢复 `running` 或 `partial` 批次时，先对账再操作：读取批次最后检查点、岗位台账、触达审计和当前 UI；若页面显示上一步已发送但台账未记录，先补齐该唯一岗位及批次计数。对账完成前不得发送新消息。

只有用户明确说“我来操作/停止”，或刷新后观察到鼠标、键盘、页面持续被外部操作，才判定为用户接管。

## 风控硬停止

出现任一情况立即保存检查点并停止当前批次：

- 验证码、安全验证、`_security_check`、429、code 37、访问频繁、账号风险或环境异常；
- 跳回登录页、登录态失效、空白异常页或非预期页面；
- 页面要求复制 Cookie、安装可疑扩展或执行站外脚本；
- 用户明确接管浏览器或明确停止；单次工具状态变化提示不构成接管证据。

停止后不得在同一次尝试中自动重试、换关键词、翻页、重新登录、切换工具或改走旧路线。报告标记 `partial`，记录实际已完成数量和唯一解锁动作。

## 批次、去重与节奏

- 启动批次前读取 `~/.boss-zhipin-scraper/ledger/job_ledger.jsonl` 和 `batches.jsonl`。
- 去重优先级：去查询参数后的职位链接 → 职位 ID → 公司+职位+地点弱键。
- 每 15 张卡片、每个结果页和每个关键词后保存搜索检查点；每次外部动作按 EXECUTE_LOOP 的事务顺序立即保存发送检查点。
- 保持串行、单次点击、单页读取；不并发操作页面。
- 不设置固定暂停、批次间隔或冷却倒计时；以页面加载完成和最新 UI 状态为下一步依据。
- 批次必须保存 `target_outreach_count`、`outreach_sent` 和 `remaining_outreach_count`。正常完成条件是目标数达成，而不是校准样本耗尽。
- 用户暂停时把批次标记为 `partial`，保存已确认发送的唯一岗位数与剩余数；恢复时沿用剩余数，不重新从目标总数开始。

## 评分基线

| 维度 | 权重 |
|---|---:|
| 岗位方向匹配 | 25 |
| 简历技能匹配 | 25 |
| 经验适配 | 15 |
| 薪资适配 | 10 |
| 地点适配 | 10 |
| 公司适配 | 10 |
| HR 活跃度 | 5 |

硬条件和风险否决优先于总分。每个判断必须给出匹配证据、风险/缺口和逐项分数；没有证据不得加分。

## 成功标准

- 首次引导、画像、两轮偏好和两个确认门均按状态完成；
- 校准阶段外部动作数为 0；
- 任何消息都有本批档位、目标数量与招呼模式授权、完整 JD、评分、风险检查和审计记录；
- 校准样本量与目标招呼数分离；执行阶段持续到达成 `target_outreach_count` 或触发真实硬停止；
- 未使用 CLI、CDP、Playwright、隐藏 API、Cookie 或反检测能力；
- 未重复触达，未越权投递或修改账号；
- 每条触达均在下一次页面动作前完成 UI 确认、岗位台账、批次计数和触达审计四项检查点；
- 台账、报告和 `partial` 状态可复核；
- 风控触发时立即停止。