AI Agent 专用的 BOSS 直聘求职 CLI 工具

These details have not been verified by PyPI

Project links

Project description

boss-agent-cli

专为 AI Agent 设计的 BOSS 直聘求职 CLI 工具

搜索职位 · 福利筛选 · 个性化推荐 · 自动打招呼 · 求职流水线 · 增量监控 · AI 简历优化

安装 · 快速开始 · Agent 集成 · 命令参考 · 架构 · 更新日志 · 路线图

中文 | English

A CLI tool designed for AI Agents to interact with BOSS Zhipin (China's largest recruitment platform). All output is structured JSON, 34 commands, 4-tier login fallback. See README.en.md for the English version.

💡 为什么用 boss-agent-cli？

传统求职：打开网页 → 翻几十页 → 逐个看详情 → 手动打招呼 → 忘了跟进谁。

boss-agent-cli 让 AI Agent 替你完成全部操作：

boss search "Golang" --city 广州 --welfare "双休,五险一金"   # 搜索 + 福利筛选
boss detail <security_id>                                    # 查看详情
boss greet <security_id> <job_id>                            # 一键打招呼
boss pipeline                                                # 流水线追踪
boss digest                                                  # 每日汇报

所有输出为 结构化 JSON，Agent 一调用就能理解，一调用就能行动。

🌟 核心能力

能力	说明	命令
🔍 职位发现	关键词搜索 + 8 维筛选 + 个性化推荐	`search` `recommend`
🎯 福利筛选	`--welfare "双休,五险一金"` 自动翻页逐条匹配	`search --welfare`
👋 主动出击	单个/批量打招呼、立即沟通投递	`greet` `batch-greet` `apply`
📊 进度管理	求职流水线 + 跟进提醒 + 每日摘要	`pipeline` `follow-up` `digest`
👀 增量监控	保存搜索条件、定期执行、标出新职位	`watch` `shortlist` `preset`
💬 沟通管理	聊天记录、结构化摘要、标签管理	`chat` `chatmsg` `chat-summary`
🤖 AI 优化	岗位分析 + 简历润色 + 匹配优化建议	`ai analyze-jd` `ai polish` `ai optimize`
📤 数据导出	CSV / JSON / HTML / Markdown 多格式	`export` `chat --export`

📦 安装

# 推荐：通过 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

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

# 5. 查看详情 → 打招呼 → 投递
boss detail <security_id>
boss greet <security_id> <job_id>
boss apply <security_id> <job_id>

# 6. 推荐 + 导出
boss recommend
boss export "Golang" --city 广州 --count 50 -o jobs.csv

# 7. 流水线 + 每日摘要
boss pipeline
boss digest

# 8. 增量监控
boss watch add my-golang "Golang" --city 广州 --welfare "双休"
boss watch run my-golang

🔐 登录链路

boss login 采用四级降级策略，适配不同环境：

级别	方式	说明	需要浏览器？
1	Cookie 提取	从本地 Chrome/Firefox/Edge 等 10+ 浏览器免扫码提取	否
2	CDP 登录	复用带 `--remote-debugging-port` 的 Chrome	需 Chrome
3	QR httpx	纯 HTTP 二维码扫码，无需安装任何浏览器	否
4	patchright	反检测 Chromium 兜底	需 Chromium

📖 CDP 启动示例

# 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

# 使用 CDP 登录
boss --cdp-url http://localhost:9222 login --cdp

🤖 AI Agent 集成

推荐先阅读：Agent Quickstart · Host Examples · Capability Matrix

方式一：Skill 安装（推荐）

npx skills add can4hou6joeng4/boss-agent-cli

安装后 Agent 自动获得调用 boss 命令的能力，无需手动配置。

方式二：手动配置

在 AI Agent 的规则文件中添加：

当用户要求搜索职位、投递、打招呼等 BOSS 直聘操作时，通过 Bash 调用 `boss` CLI：
1. 运行 `boss status` 检查登录态
2. 若未登录，运行 `boss login` 提示用户扫码
3. 根据用户意图调用 search / recommend / detail / greet
4. 解析 stdout JSON，`ok` 字段判断成败
5. 用户提到福利要求时使用 `--welfare` 参数

输出协议

所有命令输出 JSON 到 stdout，统一信封格式：

{
  "ok": true,
  "schema_version": "1.0",
  "command": "search",
  "data": [...],
  "pagination": {"page": 1, "has_more": true, "total": 15},
  "error": null,
  "hints": {"next_actions": ["boss detail <security_id>"]}
}

约定	说明
`stdout`	仅 JSON 结构化数据
`stderr`	日志和进度信息
`exit 0`	命令成功 (`ok=true`)
`exit 1`	命令失败 (`ok=false`)

📚 命令参考

基础操作

命令	说明
`boss schema`	输出 32 个命令的完整能力描述（Agent 首先调用）
`boss login`	四级降级登录
`boss logout`	退出登录
`boss status`	检查登录态
`boss doctor`	诊断环境、依赖、凭据完整性和网络
`boss me`	我的信息（用户/简历/期望/投递记录）

职位搜索

命令	说明
`boss search <query>`	搜索职位（支持 `--welfare` 筛选、`--preset` 预设）
`boss recommend`	个性化推荐
`boss detail <security_id>`	职位详情（`--job-id` 走快速通道）
`boss show <#>`	按编号查看上次搜索结果
`boss cities`	40 个支持城市

求职动作

命令	说明
`boss greet <sid> <jid>`	打招呼
`boss batch-greet <query>`	批量打招呼（上限 10）
`boss apply <sid> <jid>`	投递/立即沟通（幂等）
`boss exchange <sid>`	交换手机/微信

沟通跟进

命令	说明
`boss chat`	沟通列表（导出 html/md/csv/json）
`boss chatmsg <sid>`	聊天消息历史
`boss chat-summary <sid>`	结构化摘要
`boss mark <sid> --label X`	标签管理（9 种）
`boss interviews`	面试邀请
`boss history`	浏览历史

流水线监控

命令	说明
`boss pipeline`	求职流水线（各阶段状态）
`boss follow-up`	跟进提醒（超时未推进）
`boss digest`	每日摘要
`boss watch add/list/remove/run`	增量监控
`boss shortlist add/list/remove`	候选池
`boss preset add/list/remove`	搜索预设

简历与 AI

命令	说明
`boss resume init/list/show/edit/delete/export/import/clone/diff`	本地简历管理
`boss ai config`	配置 AI 服务
`boss ai analyze-jd`	分析岗位要求
`boss ai polish`	润色简历
`boss ai optimize`	针对目标岗位优化
`boss ai suggest`	求职建议

系统管理

命令	说明
`boss config list/set/reset`	配置管理
`boss clean`	清理缓存
`boss export <query>`	导出结果（CSV/JSON）

🔎 搜索筛选参数详解

boss search "golang" \
  --city 广州 \             # 城市（40 个可选）
  --salary 20-50K \         # 薪资范围
  --experience 3-5年 \      # 经验要求
  --education 本科 \        # 学历要求
  --scale 100-499人 \       # 公司规模
  --industry 互联网 \       # 行业
  --stage 已上市 \          # 融资阶段
  --welfare "双休,五险一金"  # 福利筛选（AND 逻辑）

福利筛选工作原理：

先检查职位福利标签（welfareList）
标签不匹配时自动获取职位描述全文搜索
自动翻页（最多 5 页）
每个结果带 welfare_match 说明匹配来源

支持关键词：双休 五险一金 年终奖 餐补 住房补贴 定期体检 股票期权 加班补助 带薪年假

🔧 诊断与排障

boss doctor

检查项	说明
`python`	Python 版本 >= 3.10
`patchright`	CLI 已安装
`patchright_chromium`	Chromium 已安装
`cookie_extract`	本地浏览器 Cookie 可提取
`auth_session`	登录态存在且可解密
`auth_token_quality`	核心凭据（wt2 / stoken）
`cookie_completeness`	辅助凭据（wbg / zp_at）
`cdp`	Chrome 调试端口可连
`network`	zhipin.com 可访问

📖 常见问题修复

# 安装浏览器内核
patchright install chromium

# 重建登录态
boss logout && boss login

# CDP 诊断
boss --cdp-url http://localhost:9222 doctor

auth_session 显示"损坏"：登录态来自旧机器指纹或文件损坏 → boss logout && boss login

auth_token_quality 各状态含义：

wt2/stoken 均存在：完整，可正常使用
wt2 存在，stoken 缺失：部分可用，接口失败时 boss login 刷新
wt2 缺失：无效 → boss logout && boss login

📖 错误码与自动修复

错误码	含义	Agent 自动修复
`AUTH_REQUIRED`	未登录	`boss login`
`AUTH_EXPIRED`	登录过期	`boss login`
`RATE_LIMITED`	频率过高	等待后重试
`TOKEN_REFRESH_FAILED`	Token 刷新失败	`boss login`
`ACCOUNT_RISK`	风控拦截	CDP Chrome 重试
`INVALID_PARAM`	参数错误	修正参数
`ALREADY_GREETED`	已打过招呼	跳过
`GREET_LIMIT`	今日次数用完	告知用户
`NETWORK_ERROR`	网络错误	重试
`AI_NOT_CONFIGURED`	AI 未配置	`boss ai config`

⚙️ 配置

boss config list            # 查看所有配置
boss config set default_city 广州   # 设置默认城市
boss config reset           # 恢复默认

📖 完整配置项

~/.boss-agent/config.json：

{
  "default_city": null,
  "default_salary": null,
  "request_delay": [1.5, 3.0],
  "batch_greet_delay": [2.0, 5.0],
  "batch_greet_max": 10,
  "log_level": "error",
  "login_timeout": 120,
  "cdp_url": null,
  "export_dir": null
}

配置项	说明
`default_city`	默认城市
`default_salary`	默认薪资范围
`request_delay`	请求间隔（秒），`[min, max]`
`batch_greet_delay`	批量打招呼间隔
`batch_greet_max`	批量打招呼上限
`log_level`	日志级别（error/warning/info/debug）
`login_timeout`	登录超时（秒）
`cdp_url`	CDP 地址
`export_dir`	导出目录

🏗️ 技术架构

CLI (Click)
    │
    ├── AuthManager ── Cookie 提取 / CDP / QR httpx / patchright
    │       └── TokenStore (Fernet + PBKDF2 机器绑定加密)
    │
    ├── BossClient ── httpx (低风险) + 浏览器 (高风险) 混合通道
    │       ├── RequestThrottle (高斯延迟 + 突发惩罚)
    │       ├── BrowserSession (CDP / Bridge / patchright)
    │       └── BOSS 直聘 wapi (18+ 端点)
    │
    ├── CacheStore (SQLite WAL)
    ├── AIService (OpenAI / Anthropic / 兼容 API)
    └── output.py → JSON 信封 → stdout

层级	选型
语言	Python >= 3.10
CLI	Click
HTTP	httpx
浏览器	patchright（Playwright 反检测 fork）
Cookie	browser-cookie3（10+ 浏览器）
加密	cryptography (Fernet + PBKDF2)
数据库	sqlite3 (WAL 模式)
渲染	rich
AI	OpenAI / Anthropic Chat Completions API
测试	pytest（666 项）

🤝 贡献

欢迎提交 Issue 和 Pull Request。

# 本地开发
git clone https://github.com/can4hou6joeng4/boss-agent-cli.git
cd boss-agent-cli
uv sync --all-extras
uv run pytest tests/ -v    # 运行测试
uv run ruff check src/     # 代码检查

详见 CONTRIBUTING.md

🙏 致谢

geekgeekrun — 浏览器自动化 + 反检测策略
boss-cli — CLI 结构化输出 + Agent 友好设计
opencli — Browser Bridge 架构理念

⚠️ 免责声明

本项目仅用于学习交流，使用时请遵守相关法律法规及 BOSS 直聘平台用户协议。因不当使用产生的一切后果由使用者自行承担，与本项目作者无关。

📑 许可证

MIT

👭 友情链接

LINUX DO - 新的理想型社区

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

1.11.0

Apr 23, 2026

1.10.1

Apr 21, 2026

1.10.0

Apr 21, 2026

1.9.1

Apr 20, 2026

1.9.0

Apr 20, 2026

1.8.18

Apr 20, 2026

1.8.17

Apr 20, 2026

1.8.16

Apr 20, 2026

1.8.15

Apr 20, 2026

1.8.14

Apr 20, 2026

1.8.13

Apr 20, 2026

1.8.12

Apr 20, 2026

1.8.11

Apr 20, 2026

1.8.10

Apr 20, 2026

1.8.9

Apr 20, 2026

1.8.8

Apr 20, 2026

1.8.7

Apr 20, 2026

1.8.6

Apr 19, 2026

1.8.5

Apr 19, 2026

1.8.4

Apr 19, 2026

1.8.3

Apr 19, 2026

1.8.2

Apr 19, 2026

1.8.1

Apr 19, 2026

1.8.0

Apr 19, 2026

This version

1.7.2

Apr 18, 2026

1.7.1

Apr 17, 2026

1.7.0

Apr 16, 2026

1.6.0

Apr 14, 2026

1.5.0

Apr 14, 2026

1.4.0

Apr 14, 2026

1.3.0

Apr 13, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

boss_agent_cli-1.7.2.tar.gz (1.2 MB view details)

Uploaded Apr 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

boss_agent_cli-1.7.2-py3-none-any.whl (135.2 kB view details)

Uploaded Apr 18, 2026 Python 3

File details

Details for the file boss_agent_cli-1.7.2.tar.gz.

File metadata

Download URL: boss_agent_cli-1.7.2.tar.gz
Upload date: Apr 18, 2026
Size: 1.2 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for boss_agent_cli-1.7.2.tar.gz
Algorithm	Hash digest
SHA256	`20cdb5cf8ec66a2aeac9c4c6e039db53ade0975389e77c456feb73c0471f8c69`
MD5	`46557d823d3ad8c55f95698d1ca3d42b`
BLAKE2b-256	`6c5af4817ac6b7c78bf4bcedc6635c08e07ee2a5d18f5bbf350b8509f2e37282`

See more details on using hashes here.

File details

Details for the file boss_agent_cli-1.7.2-py3-none-any.whl.

File metadata

Download URL: boss_agent_cli-1.7.2-py3-none-any.whl
Upload date: Apr 18, 2026
Size: 135.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for boss_agent_cli-1.7.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`e05ebd7b75b6a08c0c5e44f4d77e5198ca3856337ba7f04975b6f521e0010465`
MD5	`751e52a231b645eeed8cc659584c9625`
BLAKE2b-256	`318405b7c96041658d66fcc9b0fdc92119587035cd6088d055b9a077e61028d5`

See more details on using hashes here.

boss-agent-cli 1.7.2

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

boss-agent-cli

💡 为什么用 boss-agent-cli？

🌟 核心能力

📦 安装

🚀 快速开始

🔐 登录链路

🤖 AI Agent 集成

方式一：Skill 安装（推荐）

方式二：手动配置

输出协议

📚 命令参考

基础操作

职位搜索

求职动作

沟通跟进

流水线监控

简历与 AI

系统管理

🔧 诊断与排障

⚙️ 配置

🏗️ 技术架构

🤝 贡献

🙏 致谢

⚠️ 免责声明

📑 许可证

👭 友情链接

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes