51job-cli

51job-cli

基于 puppeteer-core / CDP（Chrome DevTools Protocol）驱动本机浏览器的前程无忧（51job）企业招聘端自动化 CLI。 适合被 AI Agent 引擎、shell 脚本或其他无人值守工具直接拉起做管线编排。

核心特性

• 真实浏览器驱动：直接外接本机的 Chrome 进程，登录态持久化本地，规避无头封号墙。
• Agent/编排友好：全流程命令独立拆分并带有明确的退出码（0 成功 / 1 业务失败 / 2 可用机制墙）；支持 --json 单文件结构化流式吐出。
• 三段式反检测防御：浏览器启动参数伪装 + DOM 原型链修复 + HTTP CDP 网络层阻断，内置风控反弹和 15s 级强力跳转自恢复。

注：本仓库为原子能力调用 CLI。 你可能在寻找的「定时循环、基于画像初发筛选、简历日报整理」等调度侧工作流位于下游仓库的 skills/recruit-daily-51job/。

---

快速上手

1. 前置环境

• Node.js: >= 20.0
• 浏览器: 本机需已安装 Google Chrome 或 Microsoft Edge（均可自动探测到；自定义指定可用环境变量 CHROME_PATH 控制）。

2. 工具安装

全局直接安装为可执行命令（推荐）

npm install -g 51job-cli

或 Clone 源码编译调试：

git clone https://github.com/se7enfive/51job-cli.git && cd 51job-cli
npm install && npm run build
npm link

3. 配置（环境变量可选）

用户级复制一份预设的环境变量模板即可（可根据机器性能、使用习惯进行调整）：

cp .env.example ~/.51job-cli/.env

---

CLI 命令集全览

共有 18 项主要可用动作模块（可随时键入 51job --help 查看全参数帮助）：

基础验证类

工具箱（查询寻源流）

候选人来源选择（AI/脚本必须先判断）

已投递 / 已聊天 / 已在人才管理列表 → talent-detail
主动人才搜索池 / search 返回的 hits → inspect
人才望远镜推荐池                 → recommend --inspect

不要混用 inspect 和 talent-detail：两者访问的是不同候选人来源。talent-detail --hi 是免费「回复」（只打开聊天面板）；inspect --hi 是搜索池「立即Hi聊」（消耗点数）。两者都不会替你发送普通文字，发送文字需先打开会话再运行 chat + send。

最小调用示例：

# 已投递候选人：查看简历
51job talent-detail 张三 --strict --json

# 搜索池候选人：先搜索，再查看详情
51job search "测绘工程师" --json
51job inspect 张三 --json

# 已知稳定简历 ID：优先使用直链
51job talent-detail --resume-id <简历ID> --json
51job inspect --resume-id <简历ID> --json

执行管线（原子级会话动作）

---

隐私、数据与安全指引

为保证跨平台多环境与个人信息规范体系防泄露：

• 数据出境同意事项（OCR Opt-in）：preview 对于人选全记录抓取的默认保存格式只提供本机纯位图 PNG 镜像快照（默认保存在 ~/.51job-cli/ocr/）。它不会执行跨网上传云打码，除非用户清晰配置环境变量 51JOB_RESUME_OCR=1 声明 opt-in（采用百度智能云组件）。
• 清理历史隐私数据：所有的留档缓存快照（如截屏照片、JSON）、调试缓存都统一支持并应规范定期实施：

  51job clean
  

• 单环境浏览器（端口占用）：系统在驱动 Chrome 会以远程 CDP （Websocket）建立端口连接通道。这要求系统只被受控使用（切忌在多进程高危权限的合租服务器不经虚拟化跑该软件，有通过端口跳层控制用户 51job 控制后台账户的操作权限风险）。