boss-cli — Boss直聘自动化 CLI | 批量发消息 · 自动打招呼 · AI Agent 招聘工具

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-cli？

| 场景 | 命令 | | --- | --- | | 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 help

macOS / 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 前端工程师

与 AI Agent 集成

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 + 交互模式

许可

GPL-3.0

相关链接

• npm：@joohw/boss-cli
• GitHub：joohw/boss-cli
• 问题反馈：Issues