boss-agent-cli — A command-line tool that automates job searching and recruiting tasks on BOSS Zhipin for humans and AI agents.

Analyzed by · AI · Job Tech · View on GitHub

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.

boss-agent-cli GitHub repository card

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:

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

I break down trending repos like boss-agent-cli every week — join the newsletter.

Browse all free repo breakdowns