// Use boss-cli for ALL BOSS 直聘 operations — searching jobs, viewing recommendations, managing applications, chatting with recruiters, and batch greeting. Invoke whenever the user requests any job search or recruitment platform interaction on BOSS 直聘.
| name | boss-cli |
| description | Use boss-cli for ALL BOSS 直聘 operations — searching jobs, viewing recommendations, managing applications, chatting with recruiters, and batch greeting. Invoke whenever the user requests any job search or recruitment platform interaction on BOSS 直聘. |
| author | jackwener |
| version | 0.3.0 |
| tags | ["boss","zhipin","boss直聘","job-search","recruitment","cli"] |
Binary: boss
Credentials: browser cookies (auto-extracted from 10+ browsers) or QR code login (--qrcode)
# Install (requires Python 3.10+)
uv tool install kabi-boss-cli
# Or: pipx install kabi-boss-cli
# Upgrade to latest (recommended)
uv tool upgrade kabi-boss-cli
# Or: pipx upgrade kabi-boss-cli
IMPORTANT FOR AGENTS: Before executing ANY boss command, check if credentials exist first. Do NOT assume cookies are configured.
boss status --json 2>/dev/null | jq -r '.authenticated' | grep -q true && echo "AUTH_OK" || echo "AUTH_NEEDED"
If AUTH_OK, skip to Command Reference.
If AUTH_NEEDED, proceed to Step 1.
Ensure user is logged into zhipin.com in any supported browser (Chrome, Firefox, Edge, Brave, Arc, Chromium, Opera, Vivaldi, Safari, LibreWolf). Then:
boss login # auto-detect browser with valid cookies
boss login --cookie-source chrome # specify browser explicitly
boss login --qrcode # QR code login — scan with Boss app
Verify with:
boss status
boss me --json | jq '.data.name'
| Symptom | Agent action |
|---|---|
环境异常 (__zp_stoken__ 已过期) | Run boss logout && boss login |
未登录 | Run boss login |
| Rate limited (code=9) | Auto-cooldown built-in; wait and retry |
| API timeout | Check network, retry |
All machine-readable output uses the envelope documented in SCHEMA.md.
Payloads live under .data.
--json / --yaml → explicit formatboss search X --json | jq .data)| Command | Description | Example |
|---|---|---|
boss search <keyword> | Search jobs with filters | boss search "golang" --city 杭州 --salary 20-30K |
boss show <index> | View job #N from last search | boss show 3 |
boss detail <securityId> | View full job details | boss detail abc123 --json |
boss export <keyword> | Export search results to CSV/JSON | boss export "Python" -n 50 -o jobs.csv |
boss recommend | Personalized recommendations | boss recommend -p 2 --json |
boss history | View browsing history | boss history --json |
boss cities | List supported cities | boss cities |
| Command | Description | Example |
|---|---|---|
boss me | View profile (name, age, degree) | boss me --json |
boss applied | View applied jobs | boss applied -p 1 --json |
boss interviews | View interview invitations | boss interviews --json |
boss chat | View communicated bosses | boss chat --json |
| Command | Description | Example |
|---|---|---|
boss greet <securityId> | Greet a boss / apply | boss greet abc123 --json |
boss batch-greet <keyword> | Batch greet from search | boss batch-greet "Python" --city 杭州 -n 5 |
boss batch-greet <keyword> --dry-run | Preview without sending | boss batch-greet "golang" --dry-run |
| Command | Description |
|---|---|
boss login | Extract cookies from browser (auto-detect, fallback QR) |
boss login --cookie-source <browser> | Extract from specific browser |
boss login --qrcode | QR code login only (terminal QR output) |
boss status | Check authentication status (shows cookie names) |
boss logout | Clear saved credentials |
| Filter | Flag | Values |
|---|---|---|
| City | --city | 北京, 上海, 杭州, 深圳, etc. (use boss cities for full list) |
| Salary | --salary | 3K以下, 3-5K, 5-10K, 10-15K, 15-20K, 20-30K, 30-50K, 50K以上 |
| Experience | --exp | 不限, 在校/应届, 1年以内, 1-3年, 3-5年, 5-10年, 10年以上 |
| Degree | --degree | 不限, 大专, 本科, 硕士, 博士 |
| Industry | --industry | 互联网, 电子商务, 游戏, 人工智能, 金融, 教育培训, 医疗健康, etc. |
| Company Scale | --scale | 0-20人, 20-99人, 100-499人, 500-999人, 1000-9999人, 10000人以上 |
| Funding Stage | --stage | 未融资, 天使轮, A轮, B轮, C轮, D轮及以上, 已上市, 不需要融资 |
| Job Type | --job-type | 全职, 兼职, 实习 |
# Preview first
boss batch-greet "golang" --city 杭州 --salary 20-30K --dry-run
# Then execute
boss batch-greet "golang" --city 杭州 --salary 20-30K -n 10 -y
# Search and extract securityId
SEC_ID=$(boss search "golang" --city 杭州 --json | jq -r '.data.jobList[0].securityId')
# Get full detail
boss detail "$SEC_ID" --json | jq '.data.jobInfo | {jobName, salaryDesc, skills}'
boss recommend --json | jq '.data.jobList | length' # Check recommendations count
boss search "Python" --city 杭州 --json # Search specific jobs
boss show 1 # View top result details
boss applied --json # Check application status
boss interviews --json # Check interview invitations
boss chat --json # Check messages
boss history --json # Review browsing history
boss export "golang" --city 杭州 --salary 20-30K -n 50 -o jobs.csv
boss export "Python" -n 100 --format json -o jobs.json
boss me --json | jq '.data | {name, age, degreeCategory}'
Structured error codes returned in the error.code field (see SCHEMA.md):
not_authenticated — cookies expired or missingrate_limited — too many requests (auto-cooldown built-in)invalid_params — missing or invalid parametersapi_error — upstream API errorunknown_error — unexpected error-v flag for debugging: boss -v search "Python" shows request timing__zp_stoken__ expires: run boss logout && boss loginboss login.