can4hou6joeng4/boss-agent-cli

uv tool install boss-agent-cli; patchright install chromium (browser kernel only used for user-initiated login / local export)
MCP: {"mcpServers":{"boss-agent":{"command":"uvx","args":["--from","boss-agent-cli[mcp]","boss-mcp"]}}}
Docker: BOSS_UID=$(id -u) BOSS_GID=$(id -g) docker compose run --rm boss-mcp (image ships without browser kernel; mount ~/.boss-agent after boss login)

Usage

• •boss doctor (env self-check) -> boss login -> boss status
• •boss search "Golang" --city 广州 --welfare "双休,五险一金" (welfare filter with AND matching, auto page-fetch)
• •boss detail <security_id>; boss shortlist add <security_id> <job_id> --tags 后端,远程; boss stats
• •MCP hosts expose ~50 low-risk/local-task tools; boss schema is the capability source of truth (also --format openai-tools / anthropic-tools)

Key features

• ✓Job discovery with 8-dimension filtering plus welfare filtering (perl-space) and local match scoring (--sort score)
• ✓Local candidate pool: shortlist, watch, preset, favorites, offline compare, funnel stats
• ✓AI job-search assistant: JD analysis, resume polish, targeted optimization, candidate matching, mock interview, chat coaching via OpenAI-compatible / Ollama / vLLM
• ✓Schema-driven JSON envelope output ({ok, data, pagination, error, hints}) on stdout; Python SDK (py.typed)
• ✓Multi-platform abstraction: zhipin (BOSS直聘), zhilian (智联招聘), qiancheng (前程无忧/51job placeholder)
• ✓Recruiter minimal loop: hr jobs list/online/offline

Best for

Chinese developers who want an AI agent to search BOSS直聘 and curate a candidate pool without risking automation bans on proactive actions

Caveats

• ⚠High-risk actions (greet/batch-greet, apply, exchange, chat, pipeline) are blocked by default and return COMPLIANCE_BLOCKED — must be done manually on the official site
• ⚠Crawl/agent automation runs only in explicit Research Mode (boss config set operating_mode research) with budgets, checkpoints, and stop switches
• ⚠qiancheng (51job) is a registered placeholder returning NOT_SUPPORTED until a read-only research bar is met
• ⚠zhilian recruiter-side automation is V1 via browser/CDP agent; hr subcommands are BOSS-only
• ⚠Local storage in ~/.boss-agent (encrypted login state, SQLite cache); data doesn't leave the machine except explicit API calls