boss-cli（@joohw/boss-cli）是开源的 Boss直聘自动化命令行工具。基于 Puppeteer / CDP 协议驱动本机 Chrome，无需 Selenium，把 Boss直聘 B 端的核心 HR 操作搬进终端：候选人列表、批量发消息、自动打招呼、在线简历预览、深度搜索、职位管理。
适合 HR 日常提效，也适合 Claude / GPT / Gemini 等 AI Agent 通过子进程调用，搭建全自动化招聘流水线。
npm install -g @joohw/boss-cli@latest
boss login
boss help纯 CLI，不内置对话式 Agent。每条命令输出结构化纯文本，Agent 可直接解析并编排多步流程。
| 场景 | 命令 |
|---|---|
| Boss直聘批量发消息 | boss send --text "..." 配合脚本循环 |
| Boss直聘自动打招呼 | boss greet <序号> [--job <岗位>] |
| Boss直聘候选人筛选 | boss list / boss list --unread |
| Boss直聘脚本自动化 | 本机 Chrome + CDP，Cookie 本地存储 |
| AI 招聘 Agent | 子进程调用，输出 Agent 友好 |
| 数据隐私 | 不经过第三方服务器，数据在 ~/.boss-cli/ |
要求：Node.js ≥ 20，本机已安装 Chrome / Chromium。
npm install -g @joohw/boss-cli@latest
boss helpmacOS / Linux 权限问题：系统 Node 默认全局前缀在
/usr/local，当前账户无写权限。建议先把全局前缀挪到用户目录（一次性配置）：mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc # bash 用 ~/.bash_profile source ~/.zshrc使用
fnm/nvm/volta的用户可跳过此步。Windows 用户无需此步。
git clone https://github.com/joohw/boss-cli.git
cd boss-cli
npm install && npm run build| 命令 | 说明 |
|---|---|
boss login |
打开 Boss直聘登录页（扫码/验证后手动完成） |
boss list [--unread] |
读取聊天列表；--unread 仅未读 |
boss chat <姓名> [--strict] |
打开指定候选人会话 |
boss send [--text <内容>] |
向当前会话发送消息 |
boss action <操作> |
索要简历 / 不合适 / 备注 / 交换微信等 |
boss recommend [岗位关键字] |
读取推荐候选人列表 |
boss greet <姓名|序号> [--job <岗位>] |
对推荐候选人打招呼（有次数限制） |
boss preview <姓名|序号> [--job <岗位>] |
在线简历预览（每日次数有限） |
boss deep-search [岗位关键字] |
深度搜索列表 / 触发立即匹配 |
boss positions |
读取职位列表 |
boss jd <名称或序号> |
抓取职位 JD 缓存到本地 |
完整用法：boss help
# 1. 登录
boss login
# 2. 查看未读候选人
boss list --unread
# 3. 打开会话并发送消息
boss chat 张三
boss send --text "您好，请问方便发一下简历吗？"
# 4. 推荐页自动打招呼
boss recommend 前端工程师
boss greet 1 --job 前端工程师boss-cli 每条命令输出纯文本，适合 LLM 通过子进程编排：
1. boss list --unread → 获取未读候选人
2. boss chat <姓名> → 打开会话
3. boss action resume → 索要简历
4. boss send -t "..." → 发送消息
5. boss recommend → 读取推荐列表
6. boss greet <序号> → 批量打招呼
详见 AGENTS.md。
boss-cli 是什么？ 开源 Boss直聘自动化 CLI，用终端命令代替手动操作 Boss直聘网页，支持 AI Agent 编排。
和 Selenium / Playwright 有什么区别？ boss-cli 基于 CDP 连接本机 Chrome，复用已有登录态，针对 Boss直聘 B 端页面做了专用封装，开箱即用。
需要额外下载浏览器吗？ 不需要。使用本机已安装的 Chrome / Chromium，通过 CDP 协议连接。
数据会上传到服务器吗？
不会。Cookie 和缓存仅存储在本地 ~/.boss-cli/，CLI 不经过任何第三方服务器。
如何无头模式运行？
设置环境变量 BOSS_BROWSER_HEADLESS=true（默认 headful，便于扫码登录）。
如何自定义操作蒙层品牌？
设置环境变量 BOSS_CLI_AGENT_BRAND=你的品牌名。
| 路径 | 内容 |
|---|---|
~/.boss-cli/.cache/ |
Cookie、浏览器用户数据 |
~/.boss-cli/jd/ |
boss jd 缓存的岗位描述 |
npm run build # 编译到 dist/
npm run dev # build + 交互模式- npm：@joohw/boss-cli
- GitHub：joohw/boss-cli
- 问题反馈：Issues