boss-agent-cli — A command-line tool that automates job searching and recruiting tasks on BOSS Zhipin for humans and AI agents.
Analyzed by Sai Pavan Gopularam · AI · Job Tech · View on GitHub
- Stars: 2220
- Forks: 191
- Commits last 30 days: 100
- Health: Active (100 commits this month)
- Language: Python
- License: MIT
What It Is
Think of it like a smart personal assistant for job hunting or recruiting, but instead of talking, you type commands into your computer. It connects directly to BOSS Zhipin, a major job platform in China, and lets you search, filter, and manage job applications or candidates right from your terminal.
This matters because it automates tedious tasks that usually take hours of manual clicking and filtering. For job seekers, it finds highly relevant jobs faster. For recruiters, it streamlines candidate management. Its structured JSON output also makes it perfect for integrating with AI agents, turning a manual process into an automated workflow.
License Verdict
MIT License — Build and Sell Freely — Commercial Use Approved • No Copyleft Restrictions
The MIT license is highly permissive. You can use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software. This means you can build commercial products, SaaS applications, or internal tools using this CLI without needing to open-source your own code.
How to Use It
Setting up the CLI involves installing it via `uv` (a fast Python package installer) and then installing a browser kernel like Chromium, which is used for user logins and local exports. Once installed, you can run the `boss` command to enter an interactive wizard or directly use specific commands for job search or recruiter tasks.
Prerequisites:
- Python 3.11+
- uv
- Chromium
Estimated setup time: 10 minutes.
uv tool install boss-agent-cli
patchright install chromium
boss login
boss search "Golang" --city 广州 --welfare "双休,五险一金"
boss hr candidates "Python" --city 101010100
What I'd Build With This
AI-Powered Job Application Assistant for China (micro-saas)
Build a web service where job seekers in China input preferences and resumes. The service uses `boss-agent-cli` to find jobs on BOSS Zhipin matching specific welfare and HR activity criteria. It then leverages the CLI's AI features to tailor resumes and cover letters for each job, providing a significant advantage in the competitive Chinese job market.
Effort: 2 Weeks Build Time · Target: Chinese Job Seekers · Pricing: $29/month for 10 tailored applications
Intelligent Recruitment Pipeline for China Market (saas)
Develop a SaaS platform for SMBs hiring in China. It integrates `boss-agent-cli` to automate candidate sourcing on BOSS Zhipin using recruiter-side features like `hr candidates` and `hr greet`. Add team collaboration, candidate tracking, and automated initial outreach to streamline the entire recruitment workflow for companies operating in China.
Effort: 3 Months Build Time · Target: SMBs Hiring in China · Pricing: $199/month per recruiter seat
Custom Job Market Intelligence for China (enterprise)
Offer custom solutions for large enterprises or market research firms. Leverage the `crawl` feature of `boss-agent-cli` for targeted, compliant data collection on job market trends, salary benchmarks, and competitor hiring activities on BOSS Zhipin. Provide aggregated, anonymized insights through custom dashboards and reports, helping strategic talent planning in China.
Effort: 6 Months Build Time · Target: Large Enterprises, Market Research · Pricing: $5,000 - $20,000+ per project/quarter
Sai Pavan Gopularam's Take
This CLI is a goldmine if you're building job tech for the Chinese market. The welfare filtering and HR activity checks are genuinely useful differentiators, not just generic search. You could easily spin up a micro-SaaS offering hyper-targeted job alerts for Chinese job seekers, charging $19/month for premium access.
Watch Out For
- Platform Specificity: This tool primarily targets BOSS Zhipin, a major Chinese job platform. While designed for extensibility, current full functionality is limited to this platform, meaning its direct utility is for the Chinese job market.
- Compliance & Risk: The tool interacts with a live platform. The README warns about platform risk, timeouts, retries, and budget controls. Users must be mindful of usage limits and platform policies to avoid account issues or rate limiting.
- Browser Kernel Dependency: For certain features like user login and local exports, a browser kernel (e.g., Chromium) needs to be installed and managed. This adds a dependency and potential complexity compared to purely API-based tools.
I break down trending repos like boss-agent-cli every week — join the newsletter.