boss-agent-cli：招聘搜索与本地候选池的事实边界
本地辅助BOSS直聘CLI，用于AI代理、搜索、福利过滤、入围名单、JSON信封输出；默认低风险且合规。
秒懂
- 它是什么？
- 围绕 boss-agent-cli 的工作路径、配置对象、验证命令与 README 已声明的限制进行中文整理。
- 适合谁用？
- boss-agent-cli 适合需要招聘搜索与本地候选池并且愿意按 README 逐项核对环境的人，不适合把仓库描述当作已完成的生产验收。先在隔离环境固定版本，执行项目明确给出的首次运行命令，检查 boss-agent-cli 的输入、输出、日志和失败退出状态，再决定是否接入真实数据或长期任务。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 2 天前。
- 用什么语言写的？
- 主要是 Python（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月14日）和我们的分析，不构成法律意见。
开源项目深度解析
boss-agent-cli 的边界与输入
README 开头解释说，自动申请和批量打招呼脚本恰恰自动化了 BOSS 直聘平台不希望被自动化的操作，被封号只是时间问题。boss-agent-cli 选择了相反的方向：它将职位搜索中低风险、只读、由用户触发的部分交给终端和 AI 代理，而将打招呼、申请、发消息等敏感操作留给用户在官方网站上手动完成。项目将合规描述为不是补丁，而是默认姿态。因此，打招呼、申请、交换联系方式、阅读候选人简历或回复等命令默认被阻止并返回 COMPLIANCE_BLOCKED。通过显式的 `boss config set operating_mode research` 可以启用有边界的浏览器协议研究，但仍要求进行脱敏、检查点、停止控制和可审计的脚本来源。README 没有定义研究模式下具体应用哪些风险控制适配，只列出了约束。 boss-agent-cli 的 README 还明确写到：<div align="center" boss-agent-cli 面向真人与 AI Agent 的招聘平台 CLI 纯终端向导 · 福利筛选 · 双角色工作流 · JSON 信封。 https://github.com/can4hou6joeng4/boss-agent-cli/actions/workflows/ci.yml https://codecov.io/gh/can4hou6joeng4/boss-agent-cli https://python.org LICENSE https://github.com/can4hou6joeng4/boss-agent-cli/releases https://pypi.org/project/boss-agent-cli/ https://github.com/can4hou6joeng4/boss-agent-cli/pulls https://mcptoplist.com/serve。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
boss-agent-cli 的核心路径
功能列表涵盖三个主要领域。职位发现包括带分层过滤器的关键词搜索，以及通过 search、show、detail 命令进行的缓存导航。差异点在于福利过滤：`--welfare "双休,五险一金"` 会翻页获取详情，并进行真正的 AND 匹配，还可用 `--sort score` 按本地匹配分数排序。本地短名单可让你查看详情、同步网页收藏的职位、用本地标签和备注组织候选人、离线比较职位，并查看漏斗统计。申请和发消息仍留在官方网站。还提供 AI 求职辅助：JD 分析、简历润色、关键词建议、简历优化、短名单匹配报告、面试准备和聊天辅导。本地模型权重不捆绑在包内，预期来自 Ollama 或 vLLM 端点。 boss-agent-cli 的 README 还明确写到：s/workflows/ci.yml https://codecov.io/gh/can4hou6joeng4/boss-agent-cli https://python.org LICENSE https://github.com/can4hou6joeng4/boss-agent-cli/releases https://pypi.org/project/boss-agent-cli/ https://github.com/can4hou6joeng4/boss-agent-cli/pulls https://mcptoplist.com/server/glama%2Fcan4hou6joeng4%2Fboss-agent-cli 快速上手 docs/getting-started.md · Agent 集成 -agent-集成 · 命令 -命令 · 排障 docs/troubleshooting.md · 路线图 ROADMAP.md · 中。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
boss-agent-cli 的配置落点
推荐的安装路径是 `uv tool install boss-agent-cli`，然后执行 `patchright install chromium` 安装浏览器内核（仅用于用户触发的登录和本地导出）。文档记录的低风险循环是 `boss doctor`、`boss login`、`boss status`，然后是搜索、详情和短名单命令，例如 `boss search "Golang" --city 广州 --welfare "双休,五险一金"` 和 `boss shortlist add <security_id> <job_id> --tags backend,remote`。每个命令都在 stdout 上输出仅 JSON 的信封，包含 `ok` 字段和退出码 0 或 1；stderr 保存日志。命令面被记录为 38 个顶层命令加上 9 个一级招聘者子命令，分组为认证、发现、组织、受限研究爬取、简历/AI、实用工具和招聘者类别。README 指向单独的 Command Reference 以获取完整参数。 boss-agent-cli 的 README 还明确写到：eases https://pypi.org/project/boss-agent-cli/ https://github.com/can4hou6joeng4/boss-agent-cli/pulls https://mcptoplist.com/server/glama%2Fcan4hou6joeng4%2Fboss-agent-cli 快速上手 docs/getting-started.md · Agent 集成 -agent-集成 · 命令 -命令 · 排障 docs/troubleshooting.md · 路线图 ROADMAP.md · 中文 | English README.en.md <a href="demo/showcase/boss-agent-cli-showcase.mp4" title="观看完整项目展示视频" </a 观看完整展示视频 demo/showcase/boss-agent-cli-showcase.mp4。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
boss-agent-cli 的运行核验
文档记录了三种集成方式。推荐的方式是带 50 个工具的 MCP 服务器，可通过 JSON 配置在 Claude Desktop 或 Cursor 中运行 `uvx --from boss-agent-cli[mcp] boss-mcp`。还提供了 Docker 选项，容器刻意不包含浏览器内核；你在主机上运行 `boss login` 并挂载 `~/.boss-agent`。第二种方式是子进程：让代理读取 `boss schema` 获取自描述，然后解析 stdout 的 JSON。第三种是 Python 嵌入，使用带类型标注的 API：`from boss_agent_cli import AuthManager, BossClient` 以及 `client.search_jobs("Golang", city="北京")`。README 还展示了一个 OpenCode 示例，复制已检查的配置文件并运行 `boss-mcp --data-dir ./.boss-agent`。 boss-agent-cli 的 README 还明确写到：eng4%2Fboss-agent-cli 快速上手 docs/getting-started.md · Agent 集成 -agent-集成 · 命令 -命令 · 排障 docs/troubleshooting.md · 路线图 ROADMAP.md · 中文 | English README.en.md <a href="demo/showcase/boss-agent-cli-showcase.mp4" title="观看完整项目展示视频" </a 观看完整展示视频 demo/showcase/boss-agent-cli-showcase.mp4 · 终端交互演示 demo/demo-zh.gif · schema 驱动 · 福利筛选 · JSON 信封 </div <p align="center" <a href="https://www.atlascloud.ai/?utm source=github&utm medium=link&。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 在隔离目录中应先执行项目文档列出的首次命令，再观察终端输出、生成的文件和退出状态；boss-agent-cli 具体要检查的对象是 招聘搜索与本地候选池，而不是只看程序是否启动。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
boss-agent-cli 的限制与风险
CLI 使用实时平台注册表。BOSS 直聘是默认平台，同时支持候选人和招聘者角色。智联招聘（zhilian）具有候选人侧只读对等，并通过 `agent` 浏览器/CDP 自动化 V1 提供招聘者流程；前程无忧（qiancheng）是注册预留项符，在满足只读研究门槛之前返回 NOT_SUPPORTED。平台选择通过 `--platform zhipin|zhilian|qiancheng` 完成，或通过 `boss config set platform zhilian` 设置默认。招聘者命令（`hr jobs list/online/offline`）目前仅支持默认招聘者平台 `zhipin-recruiter`；智联招聘者自动化通过 `agent` 命令和浏览器/CDP 适配器暴露。候选人个人数据流程默认被阻止。 boss-agent-cli 的 README 还明确写到：n.md <a href="demo/showcase/boss-agent-cli-showcase.mp4" title="观看完整项目展示视频" </a 观看完整展示视频 demo/showcase/boss-agent-cli-showcase.mp4 · 终端交互演示 demo/demo-zh.gif · schema 驱动 · 福利筛选 · JSON 信封 </div <p align="center" <a href="https://www.atlascloud.ai/?utm source=github&utm medium=link&utm campaign=boss-agent-cli" </a </p Atlas Cloud https://www.atlascloud.ai/?utm source=github&utm medium=link&utm campaign=boss-agent-cli 为 boss ai 提。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 对于 README 未说明的系统版本、网络权限、凭证保存位置和异常恢复方式，本文保留为未知项；部署前应针对 boss-agent-cli 的实际配置逐项记录结果。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
boss-agent-cli 的维护线索
架构图显示一个 Click CLI 位于合规护栏之下，护栏之上是 AuthManager、平台注册表、BossClient（httpx + 节流）、CacheStore（SQLite WAL）和 AIService（OpenAI 兼容 / Ollama / vLLM）。输出层强制在 stdout 上输出 JSON 信封。不变量：stdout 仅 JSON，stderr 保存日志，退出码为 0 或 1，错误携带 code/recoverable/recovery_action，`boss schema` 是权威能力来源。配置位于 `~/.boss-agent/config.json`，涵盖请求延迟、批量打招呼延迟、日志级别、CDP URL、导出目录和平台/角色。`~/.boss-agent/` 下的本地状态包括加密令牌、缓存搜索、短名单、本地简历、AI 配置和外部模型注册表。模型权重不捆绑在 Python 包内。 boss-agent-cli 的 README 还明确写到： 的招聘平台 CLI 纯终端向导 · 福利筛选 · 双角色工作流 · JSON 信封。 https://github.com/can4hou6joeng4/boss-agent-cli/actions/workflows/ci.yml https://codecov.io/gh/can4hou6joeng4/boss-agent-cli https://python.org LICENSE https://github.com/can4hou6joeng4/boss-agent-cli/releases https://pypi.org/project/boss-agent-cli/ https://github.com/can4hou6joeng4/boss-agent-cli/pulls https://mcptoplist.com/server/glama%2Fcan4hou6joeng4%2Fboss-agent-cli 快速上手 doc。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
boss-agent-cli 的许可证与适用人群
仓库采用 MIT 许可证，版权归 can4hou6joeng4 所有，年份为 2026。许可证授予使用、复制、修改、合并、发布、分发、再许可和出售副本的权利，且不提供任何形式的担保。README 添加了免责声明，指出该项目仅用于学习和本地辅助，用户必须遵守适用法律、BOSS 直聘用户协议及其隐私政策。默认低风险模式阻止自动化外联、批量操作、绕过风险控制和候选人个人数据流程。来源未建立任何安全保证、生产就绪或支持承诺；这些需要单独验证。 boss-agent-cli 的 README 还明确写到：oeng4/boss-agent-cli https://python.org LICENSE https://github.com/can4hou6joeng4/boss-agent-cli/releases https://pypi.org/project/boss-agent-cli/ https://github.com/can4hou6joeng4/boss-agent-cli/pulls https://mcptoplist.com/server/glama%2Fcan4hou6joeng4%2Fboss-agent-cli 快速上手 docs/getting-started.md · Agent 集成 -agent-集成 · 命令 -命令 · 排障 docs/troubleshooting.md · 路线图 ROADMAP.md · 中文 | English README.en.md <a href="demo/showcase/bo。这段信息只用于说明 boss-agent-cli 自己的输入、组件或操作路径，不能外推成未记录的性能、安全保证或兼容承诺。 使用 boss-agent-cli 时，核验记录应写清输入样本、执行参数、输出目录、日志位置和版本标签。若命令失败，应保留原始错误而不是只记录“运行成功”；若结果涉及网络、浏览器、容器、数据库或本地模型，还要把对应依赖是否存在单独列出。这样的检查对象与 招聘搜索与本地候选池 直接相关，能够区分 README 的功能描述和当前机器上的实际行为。
编辑结论
boss-agent-cli 适合需要招聘搜索与本地候选池并且愿意按 README 逐项核对环境的人，不适合把仓库描述当作已完成的生产验收。先在隔离环境固定版本，执行项目明确给出的首次运行命令，检查 boss-agent-cli 的输入、输出、日志和失败退出状态，再决定是否接入真实数据或长期任务。对 README 没有说明的权限、网络、数据保留和升级影响，不应自行补成结论。
社区笔记