boss-agent-cli

Overview

boss-agent-cli is a Python-based CLI tool designed for AI agents to interact with BOSS Zhipin, China's largest recruitment platform. It provides structured JSON outputs, schema-driven capability discovery, 4-tier login fallback, recruiter workflow support, and a cross-platform adapter layer. The tool exposes comprehensive job search functionality, communication capabilities, and resume optimization features through the MCP protocol.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• searchsearch <query> [--city <city>] [--welfare <welfare>] [--salary <range>] [--experience <range>] [--education <education>] [--scale <range>] [--industry <industry>] [--stage <stage>]

  Search for jobs with various filters including city, welfare benefits, salary, experience, education, company scale, industry, and funding stage

  Try:Search for Golang jobs in Guangzhou with benefits '双休,五险一金'Try:Find Python developer jobs in Beijing with 3-5 years experienceTry:Show me IT jobs in Shanghai with 20-50K salary range
• detaildetail <security_id> [--job-id <job_id>]

  Get detailed information about a specific job posting by security ID

  Try:Show me details for job security_id=12345Try:Get more information about this position
• greetgreet <security_id> <job_id>

  Send a greeting message to a recruiter for a specific job posting

  Try:Greet the recruiter for job security_id=12345 job_id=67890Try:Say hello to the hiring manager about this position
• applyapply <security_id> <job_id>

  Apply to a job posting or initiate communication with the recruiter

  Try:Apply to job security_id=12345 job_id=67890Try:Submit my application for this position
• pipelinepipeline

  View the current job application pipeline status and progress

  Try:Show my application pipeline statusTry:What's the current status of my job applications?
• hr applicationshr applications

  List candidate applications received for recruiter positions

  Try:Show me all job applications I've receivedTry:List candidates who have applied to my positions
• hr candidateshr candidates <keyword>

  Search for candidates with specific keywords for recruiter positions

  Try:Find candidates with 'Golang' experienceTry:Search for candidates with Python skills
• hr chathr chat

  View chat list with candidates including unread counts and recent message summaries

  Try:Show me my conversations with candidatesTry:List my recent candidate chats
• hr replyhr reply <friend_id> <message>

  Reply to a candidate message as a recruiter

  Try:Reply to candidate friend_id=12345 with 'Thank you for your application'Try:Send a message to candidate 67890
• ai analyze-jdai analyze-jd

  Analyze job description requirements using AI to identify key skills and qualifications

  Try:Analyze this job description to identify key requirementsTry:What skills are needed for this position?
• ai polishai polish

  Polish and improve resume content using AI assistance

  Try:Help me polish my resume for better impactTry:Improve the wording in my resume
• ai optimizeai optimize

  Optimize resume for a specific job position using AI

  Try:Optimize my resume for this Golang developer positionTry:Tailor my resume to match the job requirements

Comparable tools

Installation

uv tool install boss-agent-cli
patchright install chromium

{
  "mcpServers": {
    "boss-agent": {
      "command": "boss",
      "args": ["mcp"]
    }
  }
}

FAQ

Is this tool for job seekers or recruiters?

It supports both job seekers and recruiters through different role modes: --role candidate (default) and --role recruiter.

What platforms are supported?

Currently supports BOSS Zhipin (zhipin) with complete functionality, and Zhaolian Recruitment (zhilian) for job seeker side only.

Compare boss-agent-cli with