boss-agent-cli

AI Agent 专用的 BOSS 直聘本地辅助 CLI。默认低风险模式只做本地辅助、只读优先、用户主动触发，不自动触达、不批量操作、不抓取平台数据。

Install

Skills CLI

npx skills add can4hou6joeng4/boss-agent-cli

CLI

uv tool install boss-agent-cli
patchright install chromium  # only needed for browser-assisted login

First Minute

按这个顺序跑，不需要先读完整 README：

boss doctor
boss schema
boss status
boss login   # only if status reports AUTH_REQUIRED / AUTH_EXPIRED

完成标准：

• boss doctor 返回 ok=true，或给出可执行的 error.recovery_action。
• boss schema 返回当前命令、参数、平台和错误码自描述。
• boss status 返回当前登录态；未登录时由用户主动执行 boss login。

Safe Candidate Loop

求职者侧默认只推荐这个低风险闭环：

boss schema
boss search "Golang" --city 广州 --welfare "双休,五险一金"
boss detail <security_id>
boss shortlist add <security_id> <job_id>

规则：

• 先调用 boss schema，不要硬编码完整命令表。
• 只解析 stdout 的 JSON 信封；stderr 只当日志和进度信息。
• ok=false 时读取 error.code 和 error.recovery_action，不要猜测恢复步骤。
• --welfare 是核心筛选能力，适合用于低风险职位搜索和本地整理。
• 投递、打招呼、沟通、交换联系方式等动作回到平台官网由用户手动完成。

Recruiter Boundary

招聘者侧默认只保留低风险职位管理入口：

boss schema
boss hr jobs list
boss hr jobs online <job_id>
boss hr jobs offline <job_id>

候选人搜索、投递申请、在线简历、附件简历、聊天记录、消息回复、联系方式交换等链路涉及个人信息或平台关系写入，默认低风险模式会返回 COMPLIANCE_BLOCKED。遇到这类结果时，停止自动化，回到官方页面由用户手动处理。

Output Contract

所有命令都遵守同一 stdout JSON 信封：

{
  "ok": true,
  "schema_version": "1.0",
  "command": "search",
  "data": [],
  "pagination": null,
  "error": null,
  "hints": {}
}

• stdout: 只输出 JSON 信封。
• stderr: 只输出日志和进度，受 --log-level 控制。
• exit code 0: ok=true。
• exit code 1: ok=false，必须读取 error.code、error.recoverable、error.recovery_action。

Recovery

优先按错误信封恢复：

不要把登录降级、浏览器通道或 CDP 当作规避风控的手段。

Docs

• Agent Quickstart
• Agent Host Examples
• Capability Matrix
• README

License

MIT

boss-agent-cli

专为 AI Agent 设计的 BOSS 直聘本地辅助 CLI 工具

默认低风险模式：本地辅助 · 只读优先 · 用户主动触发 · 不规避风控 · 不批量触达 · 不抓取平台数据

求职者：搜索 · 福利筛选 · 详情查看 · 候选池 · 本地简历与 AI 辅助

快速上手 · 安装 · 快速开始 · 角色模式 · Agent 集成 · 命令参考 · 排障 · 架构 · 更新日志 · 路线图

中文 | English

观看完整展示视频 · 查看终端交互演示 · schema 驱动 · 福利筛选 · JSON 信封 · 开源工程质量

[!TIP]

Doloffer Guide 致力于让优质 AI 工具的获取更简单。平台主打 GPT 与 Claude 等主流 AI 服务的正版会员充值，提供一站式订阅管理，主打安全稳定与无忧售后。

💡 极速订阅： 专属链接（输入优惠码 AI8888 享 9 折特惠）

A local-assist CLI for AI Agents working around BOSS Zhipin data already available to the user. Default low-risk mode is read-only first, user-triggered, and does not automate outreach, bulk actions, risk-control bypasses, or candidate personal-data workflows. See README.en.md for the English version.

⚠️ 合规边界

本项目默认启用低风险辅助模式，目标是收缩为“本地辅助 / 只读优先 / 用户主动触发 / 不规避风控 / 不批量触达 / 不抓取平台数据”的低风险工具。CLI 默认会阻断打招呼、批量打招呼、投递、联系方式交换、招聘者候选人搜索、候选人简历、聊天记录、附件简历请求和消息回复等敏感能力。需要投递、沟通、候选人处理或联系方式交换时，请回到 BOSS 直聘官方页面由用户手动完成。

💡 为什么用 boss-agent-cli？

传统求职：打开网页 → 翻几十页 → 逐个看详情 → 手动整理候选岗位 → 忘了跟进谁。

boss-agent-cli 让 AI Agent 帮你做本地整理和只读辅助：

boss search "Golang" --city 广州 --welfare "双休,五险一金"   # 搜索 + 福利筛选
boss detail <security_id>                                    # 查看详情
boss shortlist add <security_id> <job_id>                    # 加入本地候选池
boss stats                                                   # 本地统计

所有输出为 结构化 JSON，Agent 一调用就能理解；涉及投递、沟通和候选人个人信息处理的动作默认回到平台官网手动完成。

🧭 导航目录

• 为什么用 boss-agent-cli
• 演示素材
• 核心能力
• 安装
• 快速开始
• 登录链路
• 角色模式与多平台
• AI Agent 集成
• 命令参考
• 诊断与排障
• 配置
• 技术架构
• 贡献

🎬 演示素材

🌟 核心能力

求职者工作流

• 🔍 职位发现：关键词搜索、8 维筛选、按编号回看同一条结果。命令：search show
• 🎯 福利筛选：--welfare "双休,五险一金" 会自动翻页、补抓详情、按 AND 逻辑做真实匹配。命令：search --welfare
• 📌 本地候选池：查看详情后保存、移除、复盘候选岗位；投递和沟通回到平台官网手动完成。命令：detail show shortlist
• 📊 本地统计：基于本地缓存查看候选池、投递记录和清理结果。命令：stats shortlist clean
• 👀 本地预设：保存搜索条件和候选池；自动增量拉取默认阻断。命令：watch add/list/remove preset shortlist
• 💬 沟通边界：聊天记录、会话摘要、标签和联系方式交换等敏感链路默认阻断；沟通请回到平台官网手动完成。
• 🤖 AI 求职增强：JD 分析、简历润色、定向优化、模拟面试、沟通指导。命令：ai analyze-jd ai polish ai optimize ai interview-prep ai chat-coach

招聘者工作流

• 👔 招聘者边界：候选人搜索、投递申请、在线简历、沟通记录、附件简历请求、联系方式交换和消息回复默认阻断，请回到 BOSS 直聘官方招聘者页面手动处理。
• 📌 职位管理：查看职位、上架、下架，作为招聘者端的最小可操作闭环。命令：hr jobs list hr jobs online hr jobs offline

平台与集成基础

• 🔌 多平台抽象：Platform / RecruiterPlatform 双注册表已落地；默认低风险模式优先暴露只读和本地辅助链路。命令：--platform zhipin|zhilian|qiancheng
• 📤 结构化输出：stdout 只输出 JSON 信封，适合 CLI 编排、Shell Agent、MCP 和 Python SDK。命令：schema export
• 🧩 Agent 接入：同一套能力可通过 Skill、subprocess、MCP、Python SDK 四种路径暴露给 Agent。文档：docs/agent-quickstart.md docs/agent-hosts.md

📦 安装

# 推荐：通过 uv 安装（秒级，自动隔离）
uv tool install boss-agent-cli

# 安装浏览器（仅用于用户主动登录和本地导出场景）
patchright install chromium

# pipx（隔离环境）
pipx 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

🚀 快速开始

# 1. 环境自检
boss doctor

# 2. 登录（按平台选择链路）
boss login

# 3. 验证登录态
boss status

# 可选：查看本地平台注册与能力状态（不触网）
boss platforms
boss platforms --platform qiancheng  # 仅查看单个平台；也支持 51job 别名

# 4. 搜索广州的 Golang 职位，要求双休+五险一金
boss search "Golang" --city 广州 --welfare "双休,五险一金"

# 5. 查看详情 → 加入本地候选池
boss detail <security_id>
boss shortlist add <security_id> <job_id>

# 6. 导出 + 本地统计
boss export "Golang" --city 广州 --count 50 -o jobs.csv
boss stats

# 7. 本地搜索预设（自动增量拉取默认阻断）
boss watch add my-golang "Golang" --city 广州 --welfare "双休"
boss watch list

# 9. 招聘者模式
boss hr jobs list                     # 我发布的职位（只读）
# 候选人搜索、简历、聊天、回复、联系方式交换等默认低风险模式会阻断

🔐 登录链路

boss login 会按当前平台选择登录链路：

补充说明：

• boss login 默认按当前 --platform / 配置文件里的 platform 工作
• boss --platform zhilian login 已可用，当前覆盖求职者侧认证链路
• boss --platform zhilian 目前已支持候选者侧 search / detail / user_info；推荐流和写操作默认受低风险模式阻断
• boss --platform zhilian hr ... 仍不支持，CLI 会直接拒绝执行招聘者侧子命令

涉及 Cookie、CDP、patchright、真实账号、请求频率或平台接口漂移的问题，请先阅读 平台风险边界。

macOS：

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/boss-chrome

Linux：

google-chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/boss-chrome

Windows PowerShell：

$chromeCandidates = @(
  "$env:ProgramFiles\Google\Chrome\Application\chrome.exe",
  "${env:ProgramFiles(x86)}\Google\Chrome\Application\chrome.exe",
  "$env:LOCALAPPDATA\Google\Chrome\Application\chrome.exe"
)

$chrome = $chromeCandidates | Where-Object { Test-Path $_ } | Select-Object -First 1
if (-not $chrome) { throw "Google Chrome executable was not found" }

& $chrome `
  --remote-debugging-port=9222 `
  --remote-allow-origins=* `
  --user-data-dir="$env:LOCALAPPDATA\boss-agent-cdp-profile"

启动后在另一个终端使用 CDP 登录：

boss --cdp-url http://localhost:9222 login --cdp

🎭 角色模式与多平台

boss-agent-cli 同时覆盖求职者和招聘者两端，并为后续接入更多招聘平台做了抽象。

角色切换

快捷入口：boss hr <子命令> 会自动把当前会话切换到招聘者角色，不必显式传 --role。

# 方式 A: --role 显式指定
boss --role recruiter ...

# 方式 B: 招聘者快捷组（自动切换 role）
boss hr applications
boss hr candidates "Golang"

注意：

• boss hr ... 当前仅支持默认招聘者平台 zhipin-recruiter
• 若当前平台是 zhilian，CLI 会在入口直接提示切回 boss --platform zhipin hr ...

多平台抽象

Platform / RecruiterPlatform 双注册表让命令层不耦合具体平台协议：

boss platforms 会在 JSON 与终端输出中附带 capability_status_legend，用于解释能力状态；也可以用 --capability <capability> 按现有本地能力矩阵反查平台状态，不会触发登录、浏览器/CDP 或网络请求：

# 查看哪些平台对 status 是 available / placeholder / blocked_by_policy / not_supported
boss platforms --capability status

# 可与平台过滤组合；51job 会解析为 qiancheng
boss platforms --platform 51job --capability search

--capability 的 capability_filter.status_groups 使用 Agent 友好的归一化状态名：available、placeholder、blocked_by_policy、not_supported；每个平台的 capability_match.raw_status 保留矩阵原始状态（如 placeholder_only / low_risk_blocked）。

# 指定平台
boss --platform zhilian search "Python"

# 设为默认
boss config set platform zhilian
# 51job 当前仅用于识别平台身份；真实命令会返回 NOT_SUPPORTED
boss --platform qiancheng status

设计细节见 docs/platform-abstraction.md。

🤖 AI Agent 集成

推荐先阅读：Agent Quickstart · [Host Examp