boss-cli
A CLI for BOSS 直聘 — search jobs, view recommendations, manage applications via reverse-engineered API
boss-cli is a command-line agent skill that interfaces with BOSS 直聘 (Zhipin), a Chinese job recruitment platform, via reverse-engineered APIs. It enables AI agents and developers to search jobs, view personalized recommendations, manage applications, chat with recruiters, and operate in recruiter mode to manage candidates. The tool outputs structured JSON/YAML envelopes designed for agent parsing, sends Rich formatting to stderr to avoid polluting pipes, and includes comprehensive authentication via browser cookie extraction or QR code login. It's particularly useful for automating job search workflows, candidate screening, and recruitment pipeline management through AI assistants.
Key Features
Use Cases
- 01AI agents automating job searches across multiple cities and filtering by specific salary ranges and experience requirements
- 02Recruiters managing high-volume candidate pipelines through CLI: searching talent pools, reviewing resumes, and sending batch greetings
- 03Developers building job search aggregators or alert systems that export matching positions to CSV/JSON for further processing
- 04AI assistants monitoring job application status, interview invitations, and communication history on behalf of job seekers
- 05Automated recruitment workflows that discover candidates, download resumes, and initiate conversations based on skill keywords
- 06Integration into agentic systems via Skills CLI (npx skills add jackwener/boss-cli) for job market research and candidate outreach
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
boss-cli — FAQ
What is boss-cli and what does it do?+
boss-cli is a command-line agent skill that provides programmatic access to BOSS 直聘 (Zhipin), China's leading recruitment platform. It allows both job seekers to search and apply for positions and recruiters to manage candidates, all through a terminal interface with structured output for AI agent consumption.
How do I install boss-cli?+
Install via uv tool (recommended): uv tool install kabi-boss-cli, or use pipx: pipx install kabi-boss-cli. For YAML output support, add the [yaml] extra. The package requires Python 3.10 or higher.
Which AI clients and frameworks work with boss-cli?+
boss-cli works with any AI agent framework that can invoke CLI tools and parse structured JSON/YAML output. It integrates via Skills CLI (npx skills add jackwener/boss-cli) or manual installation into .agents/skills/ directories. The SKILL.md file provides agent-ready documentation.
Do I need API keys or special credentials?+
No API keys are required. boss-cli uses browser cookie extraction or QR code login to authenticate with BOSS 直聘. Run boss login to auto-extract cookies from installed browsers, or boss login --qrcode to scan a QR code with the BOSS 直聘 mobile app.
Is boss-cli free to use?+
Yes, boss-cli is open source under the Apache-2.0 license. However, you need an existing BOSS 直聘 account (free to create) to authenticate and access job listings or recruiter features.
What happens if my session expires or I get rate-limited?+
Saved cookies auto-refresh from your browser after 7 days. If rate-limited (code=9), the tool triggers exponential backoff (10s→20s→40s→60s) with automatic retry. Run boss logout && boss login to manually refresh expired sessions.
How do I install boss-cli?+
Open the source repository on GitHub and follow its README. boss-cli is a skill — MCP Agents Market links you directly to the official repo.
Is boss-cli free?+
boss-cli is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.