mcpField
B
boss-cli

boss-cli

github.com/jackwenerProductivity1.0k357 installsUpdated 3w ago
Repository

About boss-cli

boss-cli is a command-line tool for BOSS 直聘, aimed at job seekers and automation workflows. It searches and exports listings, checks account activity, and supports greeting contacts in batches.

Key features

  1. 01Search jobs with filters
  2. 02View job details and recommendations
  3. 03Export search results
  4. 04Check applications and interviews
  5. 05Log in and check account status
  6. 06Greet job contacts in batches

Use cases

  1. 01Filter listings by city and salary
  2. 02Export search results as CSV or JSON
  3. 03Check applications, interview invitations, and chats
  4. 04Preview and batch-greet matching job contacts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jackwener/boss-cli --skill boss-cli

After installing, type/boss-cliin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
.gitignore
SCHEMA.md
pyproject.toml
uv.lock
.github/workflows/
publish.yml
ci.yml
boss_cli/
__init__.py
client.py
browser_login.py
cli.py
auth.py
index_cache.py
constants.py
exceptions.py
boss_cli/commands/
__init__.py
personal.py
social.py
search.py
auth.py
recruiter.py
_common.py
tests/
__init__.py
test_auth.py
conftest.py
test_cli.py
test_cdp_auth.py
test_smoke.py

Details

From the project README

boss-cli — BOSS 直聘 CLI Tool

Binary: boss Credentials: browser cookies (auto-extracted from 10+ browsers) or QR code login (--qrcode)

Setup

# 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

Authentication

IMPORTANT FOR AGENTS: Before executing ANY boss command, check if credentials exist first. Do NOT assume cookies are configured.

Step 0: Check if already authenticated
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.

Step 1: Guide user to authenticate

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'
Step 2: Handle common auth issues
SymptomAgent action
环境异常 (__zp_stoken__ 已过期)Run boss logout && boss login
未登录Run boss login
Rate limited (code=9)Auto-cooldown built-in; wait and retry
API timeoutCheck network, retry

Agent Defaults

All machine-readable output uses the envelope documented in SCHEMA.md. Payloads live under .data.

  • Non-TTY stdout → auto YAML
  • --json / --yaml → explicit format
  • Rich output → stderr (safe for pipes: boss search X --json | jq .data)

Command Reference

Search & Browse
CommandDescriptionExample
boss search <keyword>Search jobs with filtersboss search "golang" --city 杭州 --salary 20-30K
boss show <index>View job #N from last searchboss show 3
boss detail <securityId>View full job detailsboss detail abc123 --json
boss export <keyword>Export search results to CSV/JSONboss export "Python" -n 50 -o jobs.csv
boss recommendPersonalized recommendationsboss recommend -p 2 --json
boss historyView browsing historyboss history --json
boss citiesList supported citiesboss cities
Personal Center
CommandDescriptionExample
boss meView profile (name, age, degree)boss me --json
boss appliedView applied jobsboss applied -p 1 --json
boss interviewsView interview invitationsboss interviews --json
boss chatView communicated bossesboss chat --json
Actions
CommandDescriptionExample
boss greet <securityId>Greet a boss / applyboss greet abc123 --json
boss batch-greet <keyword>Batch greet from searchboss batch-greet "Python" --city 杭州 -n 5
boss batch-greet <keyword> --dry-runPreview without sendingboss batch-greet "golang" --dry-run
Account
CommandDescription
boss loginExtract cookies from browser (auto-detect, fallback QR)
boss login --cookie-source <browser>Extract from specific browser
boss login --qrcodeQR code login only (terminal QR output)
boss statusCheck authentication status (shows cookie names)
boss logoutClear saved credentials

Search Filter Options

FilterFlagValues
City--city北京, 上海, 杭州, 深圳, etc. (use boss cities for full list)
Salary--salary3K以下, 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--scale0-20人, 20-99人, 100-499人, 500-999人, 1000-9999人, 10000人以上
Funding Stage--stage未融资, 天使轮, A轮, B轮, C轮, D轮及以上, 已上市, 不需要融资
Job Type--job-type全职, 兼职, 实习

Agent Workflow Examples

Search → Batch Greet pipeline
# 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 → Detail pipeline (structured)
# 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}'
Daily job check workflow
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
Export pipeline
boss export "golang" --city 杭州 --salary 20-30K -n 50 -o jobs.csv
boss export "Python" -n 100 --format json -o jobs.json
Profile check
boss me --json | jq '.data | {name, age, degreeCategory}'

Error Codes

Structured error codes returned in the error.code field (see SCHEMA.md):

  • not_authenticated — cookies expired or missing
  • rate_limited — too many requests (auto-cooldown built-in)
  • invalid_params — missing or invalid parameters
  • api_error — upstream API error
  • unknown_error — unexpected error

Limitations

  • No message sending — cannot send chat messages (MQTT/Protobuf required)
  • No resume editing — cannot edit resume from CLI
  • No company search — company pages return HTML (need zp_stoken)
  • Single account — one set of cookies at a time
  • Rate limited — batch-greet has built-in 1.5s delay between greetings

Anti-Detection Notes for Agents

  • Do NOT parallelize requests — built-in Gaussian jitter delays exist for account safety
  • Rate-limit auto-recovery: if code=9 occurs, client auto-cools-down with increasing delays (10s→20s→40s→60s) and retries once
  • Use -v flag for debugging: boss -v search "Python" shows request timing
  • Batch greet limit: recommend ≤ 10 greetings per session to avoid detection
  • Cookies auto-refresh: if ≥ 7 days old, boss-cli auto-tries browser extraction
  • Re-login if __zp_stoken__ expires: run boss logout && boss login

Safety Notes

  • Do not ask users to share raw cookie values in chat logs.
  • Prefer local browser cookie extraction over manual secret copy/paste.
  • If auth fails, ask the user to re-login via boss login.
  • Agent should treat cookie values as secrets (do not echo to stdout).
  • Built-in rate-limit delay protects accounts; do not bypass it.

Comments

Markdown supported