{"data":{"slug":"can4hou6joeng4-boss-agent-cli","name":"boss-agent-cli","tagline":"Local-assist BOSS Zhipin CLI for AI agents","github_url":"https://github.com/can4hou6joeng4/boss-agent-cli","owner":"can4hou6joeng4","repo":"boss-agent-cli","owner_avatar_url":"https://avatars.githubusercontent.com/u/66450588?v=4","primary_language":"Python","stars":2013,"forks":170,"topics":["agent-skill","agent-tools","ai-agent","boss-zhipin","claude","cli","command-line","job-hunting","job-search","mcp","model-context-protocol","python","recruiter-workflow","recruitment","resume","zhipin"],"archived":false,"github_pushed_at":"2026-09-20T03:28:33+00:00","maintenance_label":"Very active","stars_delta_30d":550,"url":"https://www.graphcanon.com/tools/can4hou6joeng4-boss-agent-cli","markdown_url":"https://www.graphcanon.com/tools/can4hou6joeng4-boss-agent-cli.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/can4hou6joeng4-boss-agent-cli","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=can4hou6joeng4-boss-agent-cli","description":"🤖 Local-assist BOSS Zhipin CLI for AI agents — search, welfare filtering, shortlist, JSON-envelope output; low-risk & compliant by default.","homepage_url":"https://can4hou6joeng4.github.io/boss-agent-cli/","license":"MIT","open_issues":2,"watchers":2,"ai_summary":"A command-line interface tool designed to assist with job searching and recruitment workflows using AI agents.","readme_excerpt":"
\n\n\"boss-agent-cli\n\n# boss-agent-cli\n\n*🤖 面向真人与 AI Agent 的招聘平台 CLI —— 纯终端向导 · 福利筛选 · 双角色工作流 · JSON 信封。*\n\n\n\n\n\n\n\n\n\n\n[快速上手](docs/getting-started.md) · [Agent 集成](#-agent-集成) · [命令](#-命令) · [排障](docs/troubleshooting.md) · [路线图](ROADMAP.md) · **中文** | [English](README.en.md)\n\n\n \"boss-agent-cli\n\n\n**[观看完整展示视频](demo/showcase/boss-agent-cli-showcase.mp4)** · [终端交互演示](demo/demo-zh.gif) · schema 驱动 · 福利筛选 · JSON 信封\n\n
\n\n## 🧭 为什么\n\nboss-agent-cli 把职位发现、福利筛选、本地简历与 AI、投递沟通、招聘者候选人处理和可恢复采集统一到一个 CLI。真人直接运行 `boss` 进入纯终端向导；Agent 使用 JSON、schema、MCP 或 Python API 调用同一套 workflow 与状态。`boss schema` 始终是能力真源。\n\n## ⚠️ 运行边界\n\n历史配置 `operating_mode=assisted|research` 继续兼容，但两种模式都可调用全部已实现能力，不再产生模式级 `COMPLIANCE_BLOCKED`。平台尚未实现的能力仍准确返回 `NOT_SUPPORTED`；认证失效、账号风险和网络错误保留结构化错误与恢复动作。长流程仍受 timeout、retry、预算、checkpoint 和 stop 控制。\n\n## ✨ 核心能力\n\n- **职位发现**：关键词搜索 + 8 维筛选，按编号回看缓存结果 —— `search` `show` `detail`\n- **福利筛选（核心差异化）**：`--welfare \"双休,五险一金\"` 自动翻页补抓、按 AND 逻辑做**真实匹配**，并可 `--sort score` 按本地匹配分排序 —— `search --welfare`\n- **纯终端向导**：直接运行 `boss` 或 `boss wizard`，选择角色、平台和目标；同一 workflow 也可用 `--input-json`、run ID 或 MCP 推进和恢复\n- **本地候选池与统计**：查看详情后本地保存、读取带有效状态的网页职位收藏并仅同步有效项 / 用标签和备注复盘候选岗位、离线对比、查看漏斗统计 —— `shortlist` `stats` `watch` `preset` `favorites`\n- **AI 求职增强 + 本地模型**：JD 分析、简历润色、定向优化、候选池匹配、模拟面试、沟通指导；本地模型权重外置，支持 Ollama/vLLM OpenAI 兼容接口 —— `ai analyze-jd` `ai local configure` `ai local smoke`\n- **Schema 驱动 + JSON 信封**：stdout 只输出 `{ok, data, pagination, error, hints}` 信封，`boss schema` 是能力真源，适合 CLI 编排 / Shell Agent / MCP / Python SDK\n- **招聘者完整链路**：候选人搜索、推荐牛人、首次招呼、附件简历接收与下载、简历、聊天/最近消息、回复和职位管理 —— `hr candidates/recommendations/greet/applications/resume/chat/last-messages/reply/request-resume/accept-resume/download-resume/jobs`\n- **多平台抽象**：`Platform` / `RecruiterPlatform` 双注册表，`--platform zhipin|zhilian`\n\n## 🚀 快速开始\n\n```bash\n# 安装（uv 推荐；浏览器内核仅用于用户主动登录 / 本地导出）\nuv tool install boss-agent-cli\npatchright install chromium\n\n# 真人入口：直接进入角色、平台和目标向导\nboss\n\n# Agent / 高级用户仍可直接调用命令\nboss doctor # 环境自检\nboss login # 登录（按平台选择链路）\nboss status # 验证登录态\nboss search \"Golang\" --city 广州 --welfare \"双休,五险一金\" # 搜索 + 福利筛选\nboss detail # 查看详情\nboss shortlist add --tags 后端,远程 # 加入本地候选池并打本地标签\nboss shortlist compare --tag 远程 # 离线对比候选岗位\nboss stats # 本地统计\n\n# 招聘者模式\nboss hr candidates \"Python\" --city 101010100\nboss hr recommendations --job-id \nboss hr jobs list\n```\n\n所有命令输出结构化 JSON（`ok` 判断成败，`exit 0/1`）。完整上手见 [快速上手](docs/getting-started.md)。\n\n## 🎭 角色与多平台\n\n| 平台 | 求职者 | 招聘者 | 状态 |\n|------|:--:|:--:|------|\n| BOSS 直聘 (`zhipin`) | ✅ | ✅ | 默认 |\n| 智联招聘 (`zhilian`) | ✅ 候选者侧只读 + 本地辅助对等 | 🟡 `agent` browser/CDP 自动化 V1 | `hr` 子命令仍仅限 BOSS；智联招聘者侧通过 `boss --platform zhilian --role recruiter agent ...` 进入 |\n\n```bash\nboss --platform zhilian search \"Python\" # 指定平台（支持 --platform zhipin|zhilian）\nboss config set platform zhilian # 设为默认\n```\n\n`boss hr ...` 当前仅支持默认招聘者平台 `zhipin-recruiter`；智联招聘者侧自动化走 `agent` 命令和 browser/CDP adapter。设计细节见 [docs/platform-abstraction.md](docs/platform-abstraction.md)。\n\n## 🤖 Agent 集成\n\n推荐先读：[Agent Quickstart](docs/agent-quickstart.md) · [Capability Matrix](docs/capability-matrix.md) · [Host Examples](docs/agent-hosts.md)\n\n```json\n// 方式一：MCP（推荐）—— Claude Desktop / Cursor 等 MCP 宿主，暴露 77 个已实现工具\n{ \"mcpServers\": { \"boss-agent\": { \"command\": \"uvx\", \"args\": [\"--from\", \"boss-agent-cli[mcp]\", \"boss-mcp\"] } } }\n```\n\n不想在本机配 Python 工具链，可用仓库自带的容器：`BOSS_UID=$(id -u) BOSS_GID=$(id -g) docker compose run --rm boss-mcp`。镜像刻意不含浏览器内核 —— 先在宿主机 `boss login`，再把 `~/.boss-agent` 挂进去，详见 [Dock","github_created_at":"2026-03-20T08:41:59+00:00","created_at":"2026-07-11T11:52:04.783472+00:00","updated_at":"2026-09-20T06:41:52.97401+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"agent-skill","name":"agent-skill"},{"slug":"ai-agent","name":"ai-agent"},{"slug":"boss-zhipin","name":"boss-zhipin"},{"slug":"cli","name":"cli"},{"slug":"command-line","name":"command-line"},{"slug":"job-hunting","name":"job-hunting"},{"slug":"job-search","name":"job-search"},{"slug":"recruitment","name":"recruitment"}],"trust":{"provenance":{"is_fork":false,"github_id":1187014628,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T03:54:34.427Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":9,"days_since_push":0,"last_release_at":"2026-09-15T06:02:11Z","stars_delta_30d":550,"open_issues_delta_30d":0},"security_summary":{"status":"no_manifest","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:52:05.902Z","medium_count":0,"scan_profile":"mcp_manifest","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T03:54:35.420Z"},"deploy":{"source":"dockerfile:Dockerfile","self_host":true,"observed_at":"2026-09-20T03:54:35.420Z","managed_saas":false},"has_cli":{"value":true,"source":"pyproject.toml:[project.scripts]","observed_at":"2026-09-20T03:54:35.420Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-09-20T03:54:35.420Z"},"has_docker":{"value":true,"source":"dockerfile:Dockerfile","observed_at":"2026-09-20T03:54:35.420Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-09-20T03:54:35.420Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["Need automated search and filtering of job roles compliant with low-risk standards","Require output in JSON format suitable for integration into other tools or systems"],"when_not_to_use":["Looking for a tool that supports platforms other than BOSS Zhipin","Seeking advanced customization options beyond those provided by the default settings"],"source":"enrich:decision_facts","observed_at":"2026-07-15T08:29:49.272Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"boss-agent-cli is a Python-based CLI tool designed to assist with job searching and recruitment tasks using AI agents for BOSS Zhipin platform."}]}}