boss-agent-cli

项目简介

boss-agent-cli 将职位发现、福利筛选、本地简历与 AI、投递沟通、招聘者候选人处理和可恢复采集统一到一个 CLI。真人直接运行 boss 进入纯终端向导；Agent 使用 JSON、schema、MCP 或 Python API 调用同一套 workflow 与状态。当前注册平台为 zhipin（BOSS 直聘），覆盖求职者与招聘者角色。

核心功能

• 福利筛选：--welfare 自动翻页补抓详情，按 AND 逻辑匹配双休、五险一金等条件，并可按本地匹配分排序。
• 结构化 JSON 信封：stdout 只输出 {ok, data, pagination, error, hints} 信封，boss schema 描述当前能力与后续动作。
• 本地候选池与统计：保存、打标签、离线对比候选职位，查看漏斗统计。
• AI 求职增强：支持 JD 分析、简历润色、定向优化、模拟面试与沟通指导，可接 OpenAI 兼容 API 或本地 Ollama/vLLM 模型。
• 多入口 Agent 集成：CLI、JSON、MCP 与 Python API 共享能力与状态。
• 招聘者工作流：覆盖候选人搜索、推荐、招呼、简历接收与下载、聊天回复和职位管理。

适用场景

• 求职者按城市、关键词和福利条件检索职位，筛选近期活跃 HR，加入本地候选池复盘。
• 招聘者搜索候选人、查看推荐、发起招呼并管理简历与聊天。
• AI Agent 通过 MCP 或 subprocess 读取 boss schema，解析 JSON 信封并推进可恢复工作流。
• 用本地 Ollama/vLLM 或 OpenAI 兼容接口做 JD 分析、简历优化和面试准备。

快速开始

• 安装：uv tool install boss-agent-cli。
• 需要浏览器登录或导出时安装浏览器内核：patchright install chromium。
• 运行 boss doctor 自检，boss login 登录，再用 boss search "Golang" --city 广州 --welfare "双休,五险一金" 搜索并筛选福利。
• Agent 可先运行 boss schema 读取能力，再通过 subprocess 解析 stdout JSON；MCP 入口为 boss-mcp，Python API 可从 boss_agent_cli 导入。

部署与要求

• Python ≥ 3.11。
• 登录、导出和声明的浏览器工作流在需要时使用 Patchright 浏览器内核，可通过 patchright install chromium 安装。
• 批量采集需要额外安装 uv sync --extra crawl，并使用独立 Chrome profile，不接管日常 Chrome profile。
• 仓库自带容器镜像不含浏览器内核；可先在宿主机执行 boss login，再把 ~/.boss-agent 挂载进容器。
• 所有状态保存在 ~/.boss-agent/，包括加密登录态、搜索缓存、候选池、本地简历和 AI 配置。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。
• 平台风险码或安全页会中断当前工作流，需要按恢复命令处理。
• 长流程受超时、重试、预算、检查点和停止控制约束。
• CDP 调试端口仅限本机可信环境，不应暴露到公网或用于绕过平台风控。
• 所有来源命中平台风控时都会停止并保存检查点，适配器需有限运行、脱敏、可停止并显式恢复。
• 模型权重不随 Python 包分发，数据在未显式调用 API 或下载本地模型时保留在本机。