boss-agent-cli 安装与使用教程，实现自动化招聘 (May 15, 2026)

偶然看到的开源项目：专为 AI Agent 设计的 BOSS 直聘 CLI 工具 | GitHub

1. 软件简介

boss-agent-cli 是一个命令行工具，让 AI Agent 能够与 BOSS 直聘平台交互。支持求职者和招聘者两种角色。

• 求职者：职位搜索、自动打招呼、投递管理、增量监控、每日摘要、简历优化
• 招聘者：候选人搜索、沟通管理、简历请求、职位管理

支持平台：BOSS 直聘、智联招聘（实验性）

2. 环境要求

依赖	最低版本	本机状态
Python	3.10+	3.12.7 ✅
uv	最新	0.6.14 ✅
pip	最新	24.2 ✅
patchright	—	未安装

3. 安装步骤

方式一：uv 安装（推荐）

uv tool install boss-agent-cli
patchright install chromium

方式二：pip 安装

pip install boss-agent-cli
patchright install chromium

方式三：从源码安装

git clone https://github.com/can4hou6joeng4/boss-agent-cli.git
cd boss-agent-cli
uv sync --all-extras
uv run patchright install chromium

验证安装

boss --version
boss doctor

注意：如果安装后 boss 命令找不到，需要将 Python Scripts 目录加入系统 PATH。
uv 工具路径：%APPDATA%\uv\tools\bin 或 %USERPROFILE%\.local\bin
pip 工具路径：C:\ProgramData\anaconda3\Scripts

4. 登录认证

# 启动登录（自动打开浏览器）
boss login

# 登录后验证状态
boss status

登录超时默认 60 秒，网络慢时可调大：boss config set login_timeout 120

5. 求职者模式

命令	说明	示例
boss search	搜索职位	boss search "Golang" --city 广州
boss detail	查看职位详情	boss detail <security_id>
boss greet	向 HR 打招呼	boss greet <security_id> <job_id>
boss apply	投递简历	boss apply <security_id> <job_id>
boss pipeline	查看投递管线	boss pipeline
boss digest	每日摘要	boss digest

典型流程

boss search "Golang" --city 广州 --welfare "双休,五险一金"
boss detail abc123
boss greet abc123 job456
boss apply abc123 job456
boss pipeline

6. 招聘者模式

命令	说明
boss hr applications	查看求职申请
boss hr candidates "Golang"	搜索候选人
boss hr chat	查看聊天列表（含未读摘要）
boss hr chatmsg <friend_id>	查看聊天记录
boss hr reply <friend_id> "消息"	回复候选人
boss hr jobs list	查看已发布职位

典型流程

boss hr applications
boss hr candidates "Golang"
boss hr chat
boss hr reply friend789 "您好，我们对您的简历很感兴趣"

7. 搜索过滤

boss search "golang" \
  --city 广州 \
  --salary 20-50K \
  --experience 3-5年 \
  --welfare "双休,五险一金"

参数	说明	示例
--city	城市	广州、深圳、北京
--salary	薪资范围	20-50K
--experience	经验要求	3-5年、1-3年、不限
--welfare	福利标签（逗号分隔）	“双休,五险一金,年终奖”

可设置默认搜索条件避免重复输入：boss config set default_city 广州

8. 增量监控

# 创建监控任务
boss watch add my-golang "Golang" --city 广州 --welfare "双休"

# 执行监控（只返回新增职位）
boss watch run my-golang

# 查看所有监控
boss watch list

# 删除监控
boss watch remove my-golang

9. 配置管理

配置文件：C:\Users\<用户名>\.boss-agent\config.json

配置项

配置项	说明	默认值
default_city	默认搜索城市	—
default_salary	默认薪资范围	—
request_delay	请求间隔 [最小, 最大] 秒	—
batch_greet_delay	批量打招呼间隔 [最小, 最大] 秒	—
batch_greet_max	批量打招呼上限	—
log_level	日志级别	info
login_timeout	登录超时（秒）	60
cdp_url	远程 Chrome 调试协议 URL	—
export_dir	导出文件目录	—

配置命令

boss config list                        # 查看所有配置
boss config set default_city 广州         # 设置配置
boss config set login_timeout 120        # 设置超时
boss config reset                        # 重置所有配置

10. 常见问题

Q: 安装后 boss 命令找不到
Python Scripts 目录未加入 PATH。打开「设置 → 系统 → 关于 → 高级系统设置 → 环境变量」，在用户变量的 Path 中添加对应路径，重启终端。

Q: patchright install chromium 失败

• 网络问题：Chromium 从 Google CDN 下载，可能需要代理
• 磁盘空间：Chromium 约 400MB
• 权限不足：以管理员身份运行终端

Q: 登录超时
boss config set login_timeout 120

Q: 一键检查环境
boss doctor

Q: 请求频率限制
boss config set request_delay [2, 5]

---

boss-agent-cli v1.11.0 | 2025-05-15 | GitHub