Terminal
Terminal/Skill
Lets your agent search jobs, view recommendations, manage applications, chat with recruiters and send batch greetings on BOSS 直聘 from the command line.
By jakevin
Works with
npx skills add jackwener/boss-cli --skill boss-cliBinary: 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.