boss-agent-cli

🤖 面向真人与 AI Agent 的招聘平台 CLI —— 纯终端向导 · 福利筛选 · 双角色工作流 · JSON 信封。

快速上手 · Agent 集成 · 命令 · 排障 · 路线图 · 中文 | English

观看 48 秒发布会动画 · 交互版 · 终端交互演示 · 福利筛选 · 双角色工作流 · Agent 接入

🧭 为什么

boss-agent-cli 把职位发现、福利筛选、本地简历与 AI、投递沟通、招聘者候选人处理和可恢复采集统一到一个 CLI。真人直接运行 boss 进入纯终端向导；Agent 使用 JSON、schema、MCP 或 Python API 调用同一套 workflow 与状态。boss schema 始终是能力真源。

⚠️ 运行边界

历史配置 operating_mode=assisted|research 继续兼容，但两种模式都可调用全部已实现能力，不再产生模式级 COMPLIANCE_BLOCKED。平台尚未实现的能力仍准确返回 NOT_SUPPORTED；认证失效、账号风险和网络错误保留结构化错误与恢复动作。长流程仍受 timeout、retry、预算、checkpoint 和 stop 控制。

✨ 核心能力

• 职位发现：关键词搜索 + 8 维筛选，按编号回看缓存结果 —— search show detail
• 福利筛选（核心差异化）：--welfare "双休,五险一金" 自动翻页补抓、按 AND 逻辑做真实匹配，并可 --sort score 按本地匹配分排序 —— search --welfare
• HR 活跃度筛选：--active 3d 只留最近活跃的 HR，避免把投递次数浪费在长期不上线的岗位上；online 只看列表、请求量与普通搜索相同，其余档位可能要逐个查职位详情，更慢、风控风险更高，低风险场景建议用 --active online —— search --active
• 纯终端向导：直接运行 boss 或 boss wizard，选择角色、平台和目标；同一 workflow 也可用 --input-json、run ID 或 MCP 推进和恢复
• 本地候选池与统计：查看详情后本地保存、读取带有效状态的网页职位收藏并仅同步有效项 / 用标签和备注复盘候选岗位、离线对比、查看漏斗统计 —— shortlist stats watch preset favorites
• AI 求职增强 + 本地模型：JD 分析、简历润色、定向优化、候选池匹配、模拟面试、沟通指导；本地模型权重外置，支持 Ollama/vLLM OpenAI 兼容接口 —— ai analyze-jd ai local configure ai local smoke
• Schema 驱动 + JSON 信封：stdout 只输出 {ok, data, pagination, error, hints} 信封，boss schema 是能力真源，适合 CLI 编排 / Shell Agent / MCP / Python SDK
• 招聘者完整链路：候选人搜索、推荐牛人、首次招呼、附件简历接收与下载、简历、聊天/最近消息、回复和职位管理 —— hr candidates/recommendations/greet/applications/resume/chat/last-messages/reply/request-resume/accept-resume/download-resume/jobs
• 平台抽象：Platform / RecruiterPlatform 双注册表 + --platform 全局选项；当前注册平台为 zhipin（BOSS 直聘）

🚀 快速开始

# 安装（uv 推荐；浏览器内核仅用于用户主动登录 / 本地导出）
uv tool install boss-agent-cli
patchright install chromium

# 真人入口：直接进入角色、平台和目标向导
boss

# Agent / 高级用户仍可直接调用命令
boss doctor                                                   # 环境自检
boss login                                                    # 登录（按平台选择链路）
boss status                                                   # 验证登录态
boss search "Golang" --city 广州 --welfare "双休,五险一金"     # 搜索 + 福利筛选
boss search "Golang" --city 广州 --active 3d                  # 只看 3 日内活跃的 HR
boss detail <security_id>                                     # 查看详情
boss shortlist add <security_id> <job_id> --tags 后端,远程    # 加入本地候选池并打本地标签
boss shortlist compare --tag 远程                             # 离线对比候选岗位
boss stats                                                    # 本地统计

# 招聘者模式
boss hr candidates "Python" --city 101010100
boss hr recommendations --job-id <encJobId>
boss hr jobs list

所有命令输出结构化 JSON（ok 判断成败，exit 0/1）。完整上手见 快速上手。

🎭 角色与平台

平台	求职者	招聘者	状态
BOSS 直聘 (zhipin)	✅	✅	默认

boss platforms                             # 查看已注册平台与能力状态（当前仅 zhipin）
boss --platform zhipin search "Python"     # --platform 默认即 zhipin，可省略

boss hr ... 与招聘者侧 agent 自动化当前均只支持 zhipin-recruiter。设计细节见 docs/platform-abstraction.md。

🤖 Agent 集成