boss-agent-cli

让 AI 代理安全合规地搜索和筛选 BOSS 直聘职位，输出结构化 JSON。

boss-agent-cli 是一个面向 AI 代理的本地 BOSS 直聘命令行工具，旨在解决 AI 代理无法安全、合规地访问招聘平台数据的问题。它通过命令行接口封装了 BOSS 直聘的搜索、福利筛选和候选人短名单功能，并以 JSON 格式输出结果，便于 AI 代理直接解析和使用。项目默认采用低风险合规策略，确保操作不违反平台规则。核心能力包括：支持关键词搜索职位、按福利条件过滤、管理候选人短名单，以及通过 MCP（Model Context Protocol）与 Claude 等 AI 代理无缝集成。它用 Python 编写，技术栈涉及 agent-skill、agent-tools 等，为 AI 驱动的求职自动化提供了基础设施。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2031

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队can4hou6joeng4

所属国家

官网地址https://can4hou6joeng4.github.io/boss-agent-cli

GitHubhttps://github.com/can4hou6joeng4/boss-agent-cli

定价模式free

价格说明开源项目，MIT 许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-skill,agent-tools,ai-agent,boss-zhipin,claude,cli,command-line,job-hunting,job-search,mcp,model-context-protocol,python,recruiter-workflow,recruitment,resume,zhipin

GitHub 星标★ 2031

30天Star增速

HF 下载量

上线时间2026-03-20 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python 环境（配合 uv 工具安装器使用）
uv 包管理/工具安装器
能访问网络的终端环境
本地浏览器内核（仅用于用户主动登录 / 本地导出）

安装与启动步骤

1安装 uv 工具链

README 推荐用 uv 安装本项目，请先确保系统里已有 uv 命令；没有的话按其官方方式安装后再继续。
```
uv --version
```
2安装 boss-agent-cli

用 uv tool install 全局安装 CLI，安装完成后终端即可直接调用 boss 命令。
```
uv tool install boss-agent-cli
```
3安装浏览器内核

安装 patchright 的 chromium 内核，仅在用户主动登录或本地导出时使用，不影响其他命令。
```
patchright install chromium
```
4查看配置

列出当前全部配置项，确认配置文件已生成、默认值符合预期。
```
boss config list
```
5调整运行参数

按需修改运行模式、请求间隔、日志级别等；README 示例为把日志级别设为 debug。
```
boss config set log_level debug
```
6启动终端向导

真人用户直接运行 boss 进入纯终端向导，按提示完成搜索、福利筛选等操作。
```
boss
```

关键配置

配置项	必填	说明	示例
`operating_mode`	否	运行模式，可选 assisted 或 research，两者均可调用全部已实现能力	`assisted`
`log_level`	否	日志级别，调试时可设为 debug 查看更多输出	`debug`
`请求间隔`	否	控制请求频率的间隔配置，用于保持低频合规访问	`默认值`
`批量打招呼间隔`	否	批量打招呼时的间隔设置，避免高频操作	`默认值`
`CDP 地址`	否	浏览器 CDP 连接地址，用于登录与本地导出相关流程	`http://127.0.0.1:9222`
`导出目录`	否	本地结果导出所写入的目录路径	`/your/path/export`

如何确认成功

运行 boss config list 能正常列出配置，说明安装成功；再运行 boss 可进入终端向导。

常见问题

Q：安装后提示找不到 boss 命令怎么办？

A：确认使用的是 uv tool install boss-agent-cli，并检查 uv 工具目录是否已加入 PATH，重开终端后再试。

Q：需要装浏览器内核吗？

A：只有需要用户主动登录或本地导出结果时才需要 patchright install chromium，其余命令可先不装。

Q：运行模式 assisted 和 research 有什么区别？

A：README 说明历史配置继续兼容，两种模式都可调用全部已实现能力，不再产生模式级 COMPLIANCE_BLOCKED。

Q：提示能力不支持是怎么回事？

A：平台尚未实现的能力会返回 NOT_SUPPORTED；认证失效、账号风险和网络错误会返回结构化错误与恢复动作。

Q：怎么把配置恢复默认？

A：执行 boss config reset 即可恢复默认配置，配置文件位于 ~/.boss-agent/config.json。

注意事项

配置文件位于 ~/.boss-agent/config.json，修改前建议先备份。
项目默认采用低风险合规策略，请保持合理的请求与打招呼间隔。
长流程受 timeout、retry、预算、checkpoint 和 stop 控制，中断后可恢复。
README 未给出 AI 模型接入之外的端口、密钥等细节，请勿自行假定。

核心亮点

提供 JSON 封装输出，AI 代理可直接解析，无需处理复杂 HTML。
内置福利过滤和短名单管理，提升求职筛选效率。
默认低风险合规设计，降低触发平台风控的概率。

不足之处

仅支持 BOSS 直聘单一平台，覆盖范围有限。
文档/社区待观察，项目尚处成长阶段，生态成熟度未知。

适用场景

AI 代理驱动的自动化求职，如定时搜索新职位并推送摘要。
HR 或猎头使用 AI 工具批量筛选候选人，生成短名单。
个人开发者构建自定义求职工作流，集成到个人 AI 助手。

替代项目

jobspilot、linkedin-api、indeed-scraper

项目介绍

boss-agent-cli 是智能体领域的开源项目，由 can4hou6joeng4 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,031）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,558 增加到 2,031，净增 473。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT 许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：AI代理驱动的自动化求职，如定时搜索新职位并推送摘要。同类可对比的替代方案包括 jobspilot、linkedin-api、indeed-scraper。

上一篇：user-research-skill

下一篇：Hermes-CN-Desktop