$git clone https://github.com/can4hou6joeng4/boss-agent-cli*🤖 专为 AI Agent 设计的 BOSS 直聘本地辅助 CLI —— 搜索 · 福利筛选 · 候选池 · JSON 信封,默认 assisted,支持显式 Research Mode。*
| 1 | <div align="center"> |
| 2 | |
| 3 | <img src="docs/assets/logo.svg" width="112" alt="boss-agent-cli logo"> |
| 4 | |
| 5 | # boss-agent-cli |
| 6 | |
| 7 | *🤖 专为 AI Agent 设计的 BOSS 直聘本地辅助 CLI —— 搜索 · 福利筛选 · 候选池 · JSON 信封,默认 assisted,支持显式 Research Mode。* |
| 8 | |
| 9 | [](https://github.com/can4hou6joeng4/boss-agent-cli/actions/workflows/ci.yml) |
| 10 | [](https://codecov.io/gh/can4hou6joeng4/boss-agent-cli) |
| 11 | [](https://python.org) |
| 12 | [](LICENSE) |
| 13 | [](https://github.com/can4hou6joeng4/boss-agent-cli/releases) |
| 14 | [](https://pypi.org/project/boss-agent-cli/) |
| 15 | [](https://github.com/can4hou6joeng4/boss-agent-cli/pulls) |
| 16 | |
| 17 | [快速上手](docs/getting-started.md) · [Agent 集成](#-agent-集成) · [命令](#-命令) · [排障](docs/troubleshooting.md) · [路线图](ROADMAP.md) · **中文** | [English](README.en.md) |
| 18 | |
| 19 | <a href="demo/showcase/boss-agent-cli-showcase.mp4" title="观看完整项目展示视频"> |
| 20 | <img src="demo/showcase/boss-agent-cli-showcase.gif" alt="boss-agent-cli 项目展示动图" width="100%"> |
| 21 | </a> |
| 22 | |
| 23 | **[观看完整展示视频](demo/showcase/boss-agent-cli-showcase.mp4)** · [终端交互演示](demo/demo-zh.gif) · schema 驱动 · 福利筛选 · JSON 信封 |
| 24 | |
| 25 | </div> |
| 26 | |
| 27 | <p align="center"> |
| 28 | <a href="https://www.atlascloud.ai/?utm_source=github&utm_medium=link&utm_campaign=boss-agent-cli"> |
| 29 | <img src="docs/assets/atlas-cloud-logo.png" alt="Atlas Cloud" width="180"> |
| 30 | </a> |
| 31 | </p> |
| 32 | |
| 33 | > 🎁 **[Atlas Cloud](https://www.atlascloud.ai/?utm_source=github&utm_medium=link&utm_campaign=boss-agent-cli)** 为 `boss ai` 提供了一个全模态、OpenAI 兼容的推理入口 —— 一个 key 即可访问 DeepSeek、Qwen、GLM、Kimi、MiniMax、Claude、GPT 等模型,无需逐家接入。在 `boss ai config` 里选用 `--provider atlas`(`base_url=https://api.atlascloud.ai/v1`、默认模型 `deepseek-ai/deepseek-v4-pro`)即可,配置详见 [AI 模型接入](docs/integrations/ai-models.md#atlas-cloud一个-key-覆盖多家模型);预算友好的 [coding plan](https://www.atlascloud.ai/console/coding-plan)。 |
| 34 | |
| 35 | > [!TIP] |
| 36 | > <img src="https://github.com/peterfei/ai-agent-team/raw/main/examples/doloffer.png" alt="Doloffer logo" width="220"> |
| 37 | > |
| 38 | > **Doloffer Guide** 致力于让优质 AI 工具的获取更简单。平台主打 GPT 与 Claude 等主流 AI 服务的正版会员充值,提供一站式订阅管理,主打安全稳定与无忧售后。 |
| 39 | > |
| 40 | > 💡 **极速订阅**: [专属链接](https://doloffer.com/friend/BEv3yvKS)(输入优惠码 `AI8888` 享 9 折特惠) |
| 41 | |
| 42 | ## 🧭 为什么 |
| 43 | |
| 44 | 自动投递、批量打招呼这类求职脚本,本质是在替平台做它不希望自动化的事——账号被封只是时间问题。boss-agent-cli 反其道而行:**把「低风险、只读、你主动触发」的那部分交给终端和 Agent,把打招呼 / 投递 / 沟通这类敏感动作留给你在官网手动完成。** 你描述期望,Agent 负责搜索、筛选、整理候选岗位并输出结构化 JSON;`boss schema` 是能力真源,天然适配 Claude / Cursor 等 MCP 宿主。合规不是事后补丁,而是默认姿态。 |
| 45 | |
| 46 | ## ⚠️ 合规边界 |
| 47 | |
| 48 | 默认启用 **Assisted Mode**:本地辅助 · 只读优先 · 用户主动触发。打招呼(greet / batch-greet)、投递、联系方式交换、招聘者候选人搜索 / 简历 / 聊天、消息回复等敏感能力默认阻断并返回 `COMPLIANCE_BLOCKED`;需要时请回到 BOSS 直聘平台官网由用户手动完成。仓库同时允许显式 `boss config set operating_mode research` 启用 **Research Mode**,用于有界的浏览器协议、反调试、风控适配和受控采集研究;该模式仍要求脱敏、checkpoint、停止开关和可审计脚本来源。 |
| 49 | |
| 50 | ## ✨ 核心能力 |
| 51 | |
| 52 | - **职位发现**:关键词搜索 + 8 维筛选,按编号回看缓存结果 —— `search` `show` `detail` |
| 53 | - **福利筛选(核心差异化)**:`--welfare "双休,五险一金"` 自动翻页补抓、按 AND 逻辑做**真实匹配**,并可 `--sort score` 按本地匹配分排序 —— `search --welfare` |
| 54 | - **本地候选池与统计**:查看详情后本地保存 / 用标签和备注复盘候选岗位、离线对比、查看漏斗统计;投递与沟通回到官网手动完成 —— `shortlist` `stats` `watch` `preset` |
| 55 | - **AI 求职增强 + 本地模型**:JD 分析、简历润色、定向优化、候选池匹配、模拟面试、沟通指导;本地模型权重外置,支持 Ollama/vLLM OpenAI 兼容接口 —— `ai analyze-jd` `ai local configure` `ai local smoke` |
| 56 | - **Schema 驱动 + JSON 信封**:stdout 只输出 `{ok, data, pagination, error, hints}` 信封,`boss schema` 是能力真源,适合 CLI 编排 / Shell Agent / MCP / Python SDK |
| 57 | - **招聘者最小闭环**:职位列表与上下架(`hr jobs list/online/offline`);候选人个人数据链路默认阻断 |
| 58 | - **多平台抽象**:`Platform` / `RecruiterPlatform` 双注册表,`--platform zhipin|zhilian|qiancheng` |
| 59 | |
| 60 | ## 🚀 快速开始 |
| 61 | |
| 62 | ```bash |
| 63 | # 安装(uv 推荐;浏览器内核仅用于用户主动 |