boss-recruit-bot
Boss直聘招聘方自动化工具:多岗位打招呼 + 接受简历 + 索要简历 + 审计日志
功能
- 多岗位轮打打招呼(按优先级顺序,每日总量上限100)
- 聊天巡检(发招呼语 → 接受附件简历 → 索要简历)
- 推荐页筛选并验证生效,筛选失败时停止当前岗位
- 候选人关键词匹配(
any/all,支持排除词) - 本地原子计数、岗位每日上限、总量硬上限100
- Boss 页面可见上限提示、剩余次数和可见计数检测
- 本机 CDP、Boss 页面、登录态和前端版本检查
- 安全措施(随机间隔 + 付费墙检测 + 熔断器 + 审计日志)
- 独立profile,不影响HR日常Chrome
运行环境
- Node.js 20 及以上
- Google Chrome
- macOS 或 Windows
setup 会自动检测系统:macOS 创建 launchd 配置,Windows 在启动文件夹创建 VBS。两端均使用独立 Chrome profile 和本机 CDP 端口,不使用 Windows 全局自动按 Enter。
安装
git clone https://gitea.d-robotics.cc/hui.hu/boss-recruit-bot-newest ~/boss-recruit-bot
cd ~/boss-recruit-bot
npm install
npm run build
cp config.example.json config.json
如需直接使用 boss-bot 命令,可在项目目录执行 npm link;也可以始终使用下面的 npx tsx src/cli/index.ts 方式。
使用
# 配置 Chrome 开机自启(可选,macOS/Windows)
npx tsx src/cli/index.ts setup
# 登录(首次扫码)
npx tsx src/cli/index.ts login
# 检查本机 CDP、Boss 页面、登录态、前端版本和配置摘要
npx tsx src/cli/index.ts check
# 执行一次招聘流程(巡检后打招呼)
npx tsx src/cli/index.ts loop
# 手动扫简历(接受+索要)
npx tsx src/cli/index.ts scan-resumes
# 查看今日统计
npx tsx src/cli/index.ts stats
# 查看最近20条审计记录
npx tsx src/cli/index.ts audit --limit 20
loop 每次只执行一轮后退出,不会自动循环。需要分批招聘时,由调用方按指定次数和间隔再次执行。
check 只探测 127.0.0.1 上配置的 CDP 端口,并检查已打开的 Boss 页面。Chrome 未启动、未打开 Boss、停留在登录页、未检测到已登录主界面或前端版本不匹配时,命令返回失败状态。
配置
编辑 config.json 的 positions 数组配置岗位:
- name: 岗位名称
- priority: 优先级(数字小的先打)
- dailyLimit: 每日此岗位打招呼上限
- autoMessageText: 顶层全局配置,会话窗口统一发送的消息
- recommendGreet.applyFilters: 是否使用 Boss 推荐页筛选,默认
false - recommendGreet.filterSteps: HR 明确指定的筛选步骤,默认空数组
- keywords.matchMode:
any表示命中任一包含词,all表示必须命中全部包含词 - keywords.include/exclude: 候选人包含词和排除词;排除词优先
首次配置或新增岗位时,应先询问 HR 是否需要筛选。默认不筛选;年龄、性别、院校、第一学历、学历层次等条件只有在 HR 明确提出并确认后才能配置。
开启筛选后,工具会验证每项条件和年龄滑块最终值,并在点击确认后验证筛选面板是否关闭。任一验证失败时停止当前岗位,不会在筛选未生效的情况下继续打招呼;筛选结果为 0 人时正常结束。
每个岗位受自身 dailyLimit 限制,所有岗位共享 safety.maxGreetsPerDay;实际总上限为 min(safety.maxGreetsPerDay, 100),无需要求各岗位 dailyLimit 之和小于100。每次打招呼前会原子预占本地额度,失败时归还。
推荐页执行前、批次中和每次点击后,工具会读取当前 Boss 页面及 iframe 的可见文本。页面明确显示今日已达上限、剩余次数为 0,或显示的今日计数达到上限时,工具立即停止全部岗位。该检测只读取页面 DOM,不请求 Boss 业务接口。
stats 展示的仍是本地状态计数,页面检测也不等同于完整后台统计。Boss 未显示额度、人工打招呼、其他工具操作或状态文件丢失时,请在 Boss 后台核对实际总量。
跨平台说明
| 项目 | macOS | Windows |
|---|---|---|
| 开机自启 | launchd | 启动文件夹 VBS |
| 独立 profile | /tmp/boss-chrome-profile |
%LOCALAPPDATA%\\boss-chrome-profile |
| CDP 检查 | 127.0.0.1:<cdpPort> |
127.0.0.1:<cdpPort> |
工具通过可见浏览器页面完成必要操作。浏览器正常加载 Boss 页面和连接本机 CDP 是运行所必需的;招聘流程不会主动请求 Boss 数据页、wapi 会话接口或外部版本检查地址。
免责声明
使用浏览器自动化访问 Boss 直聘可能违反其服务条款。 使用本工具产生的任何后果由使用者自行承担。