Boss Agent CLI

Boss Agent CLI is a command-line client for BOSS Zhipin, the Chinese recruitment platform, built for both people and AI agents. It covers the job-seeker workflow (job search, benefit filtering, a local shortlist, resume work with AI, applications, and chat) and the recruiter workflow (candidate search, recommendations, greetings, resume requests and downloads, chat, and job management) in one tool.

People run an interactive terminal wizard that walks through role, platform, and goal. Agents call the same workflows through four routes: an MCP server exposing 77 tools for hosts such as Claude Desktop and Cursor, subprocess calls that parse JSON from stdout, a typed Python API, and an OpenCode project example. Every command writes a single JSON envelope with ok, data, pagination, error, and hints fields, and a schema command describes all capabilities and can export them as OpenAI or Anthropic tool definitions.

Benefit filtering is the distinguishing search feature: it pages through results, fetches job details, and matches requested benefits such as weekends off or social insurance with AND logic, then sorts by a local match score. AI features (job-description analysis, resume polishing and targeting, shortlist matching, mock interviews, cover letters, and chat coaching) call any OpenAI-compatible or Anthropic-compatible API, including local models through Ollama or vLLM.

State stays on the local machine: encrypted login credentials, search cache, shortlist, resumes, and AI settings. A resumable crawl mode runs under fixed budgets for requests, details, wall-clock time, and retries, saves SQLite checkpoints, and stops when the platform returns a risk signal. Errors carry a code, a recoverable flag, and a recovery action so agents can respond programmatically. A platform abstraction allows further recruitment sites, though BOSS Zhipin is the only one registered.