推荐牛人简历下载

核心目标：安全地从推荐牛人页面拉候选人列表 + 下载完整简历。

安全级别：🟢 极低风险（真实 Edge TLS 指纹 + 随机延迟）

---

流程

Step 2a: scripts/recommend_list.py
  patchright 滚动 + 拦截 geek/list API
        ↓
Step 2b: scripts/recommend_download.py
  patchright + 浏览器 fetch（真实 Edge 指纹）
        ↓
输出: runs/<run_id>/process/new_resumes.json

核心原理：通过 patchright 在真实 Edge 浏览器内执行 fetch() 调用 BOSS API， 使用浏览器真实的 TLS 指纹和 Cookie，与真人操作完全一致。

---

前置条件

项	要求
Python	3.10+
patchright	pip install patchright
Edge	--remote-debugging-port=9222 启动
BOSS 招聘者	扫码登录完成（zp_at/wt2/bst cookie 齐全）
Step 1	已跑通 boss_jd.py，拿到 encryptJobId + run_id
确认门	runs/<run_id>/run.json.confirmed=true

登录态由 shared/cdp_preflight.check_login() 自检。

---

Step 2a: 拉候选人列表

脚本：scripts/recommend_list.py

原理：在推荐牛人页面滚动时，前端懒加载调用 geek/list API。用 patchright 拦截响应，提取候选人 ID。

调用

python scripts/recommend_list.py \
  --job-name "<岗位中文名>" \
  --encrypt-job-id "<BOSS encryptJobId>" \
  --run-id "<run_id>" \
  --batch-size 25

参数

参数	必填	说明
--job-name	是	岗位中文名（jobs.json metadata）
--encrypt-job-id	是	工作区目录名 = encryptJobId
--run-id	是	当前 run_id（数据边界）
--batch-size	否	默认 25；调到 50 也行，但别超过

输出

runs/<run_id>/process/recommend_geek_ids.json

---

Step 2b: 下载简历

脚本：scripts/recommend_download.py

原理：patchright 在浏览器内 fetch /wapi/zpjob/view/geek/info，使用真实 Edge TLS 指纹 + Cookie。

调用

python scripts/recommend_download.py \
  --job-name "<岗位中文名>" \
  --encrypt-job-id "<BOSS encryptJobId>" \
  --run-id "<run_id>" \
  --max 5

参数

参数	必填	说明
--job-name	是
--encrypt-job-id	是
--run-id	是
--max	否	最多下载多少份（建议 5~10 起步）

输出

文件	内容
runs/<run_id>/process/new_resumes.json	本次新增成功简历
runs/<run_id>/process/failed_resumes.json	失败列表

跨 run 累计简历在 state/resumes_master.json（自动去重）。

---

完整简历数据结构

{
  "name": "张三",
  "age": "25岁",
  "degree": "本科",
  "work_years": "3年",
  "work_experience": [
    {
      "company": "XX 公司",
      "position": "测试工程师",
      "start": "2023.09",
      "end": "2026.06",
      "duration": "2年9个月",
      "responsibility": "..."
    }
  ],
  "project_experience": [
    {
      "name": "XX 项目",
      "role": "测试工程师",
      "start": "2025.04",
      "end": "2026.06",
      "description": "..."
    }
  ],
  "education": [
    {
      "school": "XX 大学",
      "major": "车辆工程",
      "degree": "本科"
    }
  ],
  "certifications": ["英语四级"],
  "_meta": {
    "encrypt_geek_id": "...",
    "encrypt_job_id": "...",
    "downloaded_at": "..."
  }
}

注：age / certifications / _meta 等字段在 Step 3a 净化层会被剥离（详见 resume-screener/SKILL.md § 净化层字段规则）。

---

安全策略

真实浏览器指纹

• TLS 指纹 = 真实 Edge 浏览器
• Cookie = 用户真实登录 session
• 请求头 = 浏览器自动添加的标准头
• BOSS 服务器无法与真人操作区分

随机延迟（脚本内置）

操作	延迟
页面滚动	3-6 秒
获取简历	60-120 秒（每 5 份触发一次长延迟）

运行建议

• 推荐工作时间（9:00-18:00）
• 单次建议不超过 50 人
• 遇到"今日查看已达上限"立即停止

---

故障排查

今日查看已达上限

BOSS 每日查看简历数量限制。等第二天额度刷新后继续。

fetch 返回空数据或报错

通常是登录 session 过期。在 9222 Edge 窗口里重新扫码登录，然后跑 shared/cdp_preflight.check_login() 自检。

滚动时没有加载更多候选人

脚本已在 iframe 内滚动。如仍有问题，确认推荐牛人页面已正确加载，且 BOSS 推荐了候选人。