boss-agent-cli

Category: Tools & Productivity | Uploader: can4hou6joeng4 | Downloads: 0 | Version: v1.0（Latest）

> AI Agent 专用的 BOSS 直聘双端 CLI 工具 — 33 个顶层命令 + 7 个招聘者子命令，覆盖职位搜索、福利筛选、沟通、流水线、招聘者工作流、MCP 工具与 AI 简历优化。

Changelog: Source: GitHub https://github.com/can4hou6joeng4/boss-agent-cli

Directory Structure

Current level: tree/master/

📁 .agents/
- 📁 skills/
  - 📄 boss-agent-cli 27 B
📁 .devcontainer/
- 📄 devcontainer.json 982 B
📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.yml 2.9 KB
  - 📄 config.yml 682 B
  - 📄 documentation.yml 1.1 KB
  - 📄 feature_request.yml 2.6 KB
- 📁 workflows/
  - 📄 ci.yml 2.6 KB
  - 📄 pages.yml 697 B
  - 📄 release.yml 901 B
- 📄 CODEOWNERS 440 B
- 📄 dependabot.yml 421 B
- 📄 PULL_REQUEST_TEMPLATE.md 1.9 KB
- 📄 social-preview.png 370.6 KB
📁 demo/
- 📁 assets/
  - 📄 icons.svg 1.9 KB
- 📄 index.html 16.7 KB
- 📄 main.js 4.8 KB
- 📄 style.css 15.8 KB
📁 docs/
- 📁 assets/
  - 📄 social-preview.html 10.1 KB
- 📁 blog/
  - 📄 en-launch-story.md 5.1 KB
  - 📄 zh-launch-story.md 5.5 KB
- 📁 integrations/
  - 📄 ai-models.md 3.2 KB
  - 📄 claude-code.md 1.7 KB
  - 📄 codex.md 1.7 KB
  - 📄 cursor.md 2.9 KB
  - 📄 python-sdk.md 7.6 KB
  - 📄 shell-agent.md 1.4 KB
  - 📄 windsurf.md 2.8 KB
- 📁 research/
  - 📁 platforms/
    
    📄 lagou.md 8.3 KB
    
    📄 liepin.md 8.1 KB
    
    📄 README.md 3.0 KB
    
    📄 zhaopin.md 8.8 KB
  - 📄 bridge-grpc.md 6.9 KB
- 📁 superpowers/
  - 📁 specs/
    
    📄 2026-04-15-anything-analyzer-findings.md 6.7 KB
- 📄 agent-hosts.md 2.0 KB
- 📄 agent-quickstart.md 2.3 KB
- 📄 awesome-submissions.md 6.8 KB
- 📄 capability-matrix.md 3.8 KB
- 📄 platform-abstraction.md 7.0 KB
- 📄 promotion-article.md 4.1 KB
- 📄 smoke-testing.md 609 B
📁 extension/
- 📄 background.js 8.8 KB
- 📄 manifest.json 550 B
- 📄 popup.html 1.1 KB
📁 mcp-server/
- 📄 README.md 4.5 KB
- 📄 server.py 567 B
📁 scripts/
- 📄 smoke_p0.py 2.2 KB
📁 skills/
- 📁 boss-agent-cli/
  - 📄 SKILL.md 9.0 KB
📁 src/
- 📁 boss_agent_cli/
  - 📁 ai/
    
    📄 __init__.py 0 B
    
    📄 config.py 4.2 KB
    
    📄 prompts.py 6.2 KB
    
    📄 service.py 2.2 KB
  - 📁 api/
    
    📄 __init__.py 0 B
    
    📄 boss.yaml 5.5 KB
    
    📄 browser_client.py 10.5 KB
    
    📄 client.py 11.8 KB
    
    📄 endpoints.py 3.5 KB
    
    📄 endpoints_loader.py 3.0 KB
    
    📄 models.py 3.3 KB
    
    📄 recruiter.yaml 4.5 KB
    
    📄 recruiter_client.py 10.6 KB
    
    📄 recruiter_endpoints.py 3.5 KB
    
    📄 throttle.py 1.6 KB
    
    📄 zhilian_client.py 5.4 KB
  - 📁 auth/
    
    📄 __init__.py 0 B
    
    📄 browser.py 6.0 KB
    
    📄 cookie_extract.py 2.0 KB
    
    📄 manager.py 5.0 KB
    
    📄 qr_login.py 3.1 KB
    
    📄 token_store.py 3.8 KB
  - 📁 bridge/
    
    📄 __init__.py 0 B
    
    📄 client.py 5.1 KB
    
    📄 daemon.py 7.5 KB
    
    📄 protocol.py 1.9 KB
  - 📁 cache/
    
    📄 __init__.py 0 B
    
    📄 store.py 11.9 KB
  - 📁 commands/
    
    📁 recruiter/
    
    📄 __init__.py 203 B
    
    📄 applications.py 1.3 KB
    
    📄 candidates.py 1.4 KB
    
    📄 chat.py 1.2 KB
    
    📄 jobs.py 1.8 KB
    
    📄 reply.py 1.1 KB
    
    📄 request_resume.py 1.3 KB
    
    📄 resume.py 2.3 KB
    
    📄 resume_parser.py 3.2 KB
    
    📄 __init__.py 0 B
    
    📄 _platform.py 1.8 KB
    
    📄 _recruiter_platform.py 774 B
    
    📄 ai_cmd.py 13.5 KB
    
    📄 apply.py 1.8 KB
    
    📄 chat.py 7.3 KB
    
    📄 chat_export.py 10.9 KB
    
    📄 chat_snapshot.py 3.2 KB
    
    📄 chat_summary.py 1.8 KB
    
    📄 chat_utils.py 974 B
    
    📄 chatmsg.py 2.8 KB
    
    📄 cities.py 568 B
    
    📄 clean.py 5.1 KB
    
    📄 config_cmd.py 4.7 KB
    
    📄 detail.py 4.2 KB
    
    📄 digest.py 2.8 KB
    
    📄 doctor.py 9.4 KB
    
    📄 exchange.py 1.9 KB
    
    📄 export.py 6.7 KB
    
    📄 greet.py 6.7 KB
    
    📄 history.py 1.4 KB
    
    📄 interviews.py 1.6 KB
    
    📄 login.py 1.7 KB
    
    📄 logout.py 694 B
    
    📄 mark.py 2.6 KB
    
    📄 me.py 2.6 KB
    
    📄 pipeline.py 2.7 KB
    
    📄 preset.py 3.2 KB
    
    📄 recommend.py 2.0 KB
    
    📄 resume_cmd.py 11.0 KB
    
    📄 schema.py 24.0 KB
    
    📄 search.py 7.0 KB
    
    📄 shortlist.py 2.4 KB
    
    📄 show.py 2.6 KB
    
    📄 stats.py 10.1 KB
    
    📄 status.py 1023 B
    
    📄 watch.py 5.5 KB
  - 📁 platforms/
    
    📄 __init__.py 2.6 KB
    
    📄 base.py 5.5 KB
    
    📄 recruiter_base.py 6.3 KB
    
    📄 zhilian.py 2.9 KB
    
    📄 zhipin.py 4.0 KB
    
    📄 zhipin_recruiter.py 5.4 KB
  - 📁 resume/
    
    📄 __init__.py 0 B
    
    📄 export.py 1.3 KB
    
    📄 models.py 5.4 KB
    
    📄 store.py 3.2 KB
    
    📄 templates.py 5.5 KB
  - 📄 __init__.py 1.3 KB
  - 📄 chat_summary.py 1.2 KB
  - 📄 config.py 649 B
  - 📄 digest.py 4.4 KB
  - 📄 display.py 9.9 KB
  - 📄 hooks.py 1.8 KB
  - 📄 index_cache.py 2.6 KB
  - 📄 main.py 5.4 KB
  - 📄 match_score.py 3.5 KB
  - 📄 mcp_server.py 26.7 KB
  - 📄 output.py 1.8 KB
  - 📄 pipeline_state.py 2.4 KB
  - 📄 py.typed 0 B
  - 📄 search_filters.py 11.2 KB
📁 tests/
- 📄 test_agent_docs.py 4.4 KB
- 📄 test_agent_host_examples.py 1.5 KB
- 📄 test_ai_commands.py 32.4 KB
- 📄 test_ai_config.py 7.3 KB
- 📄 test_ai_prompts.py 3.7 KB
- 📄 test_ai_service.py 6.7 KB
- 📄 test_api.py 6.4 KB
- 📄 test_api_client_methods.py 11.6 KB
- 📄 test_api_client_retry.py 5.6 KB
- 📄 test_apply.py 2.5 KB
- 📄 test_auth.py 1.5 KB
- 📄 test_auth_and_login_extended.py 10.0 KB
- 📄 test_auth_manager_extended.py 9.5 KB
- 📄 test_auth_manager_flow.py 5.6 KB
- 📄 test_bridge.py 7.0 KB
- 📄 test_bridge_extended.py 9.1 KB
- 📄 test_browser_client.py 4.7 KB
- 📄 test_cache.py 5.0 KB
- 📄 test_cache_extended.py 7.1 KB
- 📄 test_chat_export_extended.py 16.2 KB
- 📄 test_chat_snapshot_extended.py 13.5 KB
- 📄 test_chat_summary.py 1.5 KB
- 📄 test_chat_summary_command.py 1.8 KB
- 📄 test_chatmsg_extended.py 15.7 KB
- 📄 test_clean_cmd.py 6.5 KB
- 📄 test_commands.py 31.6 KB
- 📄 test_config_cmd.py 5.5 KB
- 📄 test_cookie_extract_regression.py 5.6 KB
- 📄 test_coverage_second_sprint.py 9.2 KB
- 📄 test_digest.py 738 B
- 📄 test_digest_command.py 5.1 KB
- 📄 test_display.py 9.6 KB
- 📄 test_doctor_extended.py 15.6 KB
- 📄 test_endpoints_loader.py 2.3 KB
- 📄 test_export_extended.py 10.8 KB
- 📄 test_greet_detail_extended.py 8.6 KB
- 📄 test_greet_extended.py 10.0 KB
- 📄 test_hooks.py 2.4 KB
- 📄 test_index_cache.py 3.0 KB
- 📄 test_match_score.py 1.8 KB
- 📄 test_mcp_server.py 16.4 KB
- 📄 test_new_commands.py 17.4 KB
- 📄 test_output.py 2.2 KB
- 📄 test_pipeline_commands.py 2.8 KB
- 📄 test_pipeline_state.py 2.2 KB
- 📄 test_platform_base.py 6.4 KB
- 📄 test_platform_cli.py 3.9 KB
- 📄 test_preset.py 3.1 KB
- 📄 test_public_api.py 4.8 KB
- 📄 test_qr_login.py 3.5 KB
- 📄 test_recruiter_client.py 3.6 KB
- 📄 test_recruiter_commands.py 3.2 KB
- 📄 test_recruiter_endpoints.py 735 B
- 📄 test_recruiter_platform.py 3.2 KB
- 📄 test_resume_commands.py 13.1 KB
- 📄 test_resume_export.py 6.8 KB
- 📄 test_resume_import_compat.py 3.9 KB
- 📄 test_resume_models.py 5.8 KB
- 📄 test_resume_store.py 4.4 KB
- 📄 test_resume_templates.py 7.9 KB
- 📄 test_schema_contract.py 4.3 KB
- 📄 test_schema_formats.py 4.6 KB
- 📄 test_search_filters.py 4.5 KB
- 📄 test_search_pipeline.py 5.0 KB
- 📄 test_shortlist.py 1.3 KB
- 📄 test_smoke_p0.py 1.8 KB
- 📄 test_stats.py 5.4 KB
- 📄 test_throttle.py 1.4 KB
- 📄 test_watch.py 2.8 KB
- 📄 test_welfare_filter.py 2.9 KB
- 📄 test_zhilian_client.py 7.0 KB
- 📄 test_zhilian_stub.py 5.8 KB
📄 .codecov.yml 401 B
📄 .gitattributes 119 B
📄 .gitignore 623 B
📄 .pre-commit-config.yaml 454 B
📄 CHANGELOG.md 29.2 KB
📄 CLAUDE.md 28.3 KB
📄 CODE_OF_CONDUCT.md 1.6 KB
📄 CONTRIBUTING.en.md 4.4 KB
📄 CONTRIBUTING.md 1.2 KB
📄 demo.gif 887.3 KB
📄 demo.tape 3.7 KB
📄 demo_showcase.py 1.5 KB
📄 Dockerfile 235 B
📄 glama.json 100 B
📄 LICENSE 1.0 KB
📄 pyproject.toml 4.6 KB
📄 README.en.md 14.7 KB
📄 README.md 19.8 KB
📄 ROADMAP.md 4.2 KB
📄 SECURITY.md 1.1 KB
📄 SKILL.md 7.6 KB
📄 uv.lock 517.4 KB

SKILL.md

# boss-agent-cli

> AI Agent 专用的 BOSS 直聘双端 CLI 工具 — 33 个顶层命令 + 7 个招聘者子命令，覆盖职位搜索、福利筛选、沟通、流水线、招聘者工作流、MCP 工具与 AI 简历优化。

## Install

### Skills CLI (Recommended)

```bash
npx skills add can4hou6joeng4/boss-agent-cli
```

### pip / uv tool

```bash
uv tool install boss-agent-cli
patchright install chromium
```

## Setup

```bash
boss login     # 四级降级：Cookie 提取 → CDP → QR httpx → patchright 扫码
boss status    # 验证登录态
```

## Agent Decision Tree

```
用户意图 → 选择命令链
│
├─ "帮我找工作"
│   → boss status → boss search "关键词" --city X --welfare "Y"
│   → boss detail <sid> → boss greet <sid> <jid>
│
├─ "有什么新职位？"
│   → boss watch run <name>  (已有监控)
│   → boss recommend         (个性化推荐)
│
├─ "我的求职进展怎样？"
│   → boss pipeline → boss follow-up → boss digest
│
├─ "帮我优化简历"
│   → boss ai analyze-jd → boss ai polish → boss ai optimize
│
├─ "查看沟通记录"
│   → boss chat → boss chatmsg <sid> → boss chat-summary <sid>
│
├─ "登录/环境有问题"
│   → boss doctor → boss login
│
└─ "不知道能做什么"
    → boss schema  (返回全部能力 JSON)
```

## Commands

当前 `boss schema` 暴露：
- **33 个顶层命令**
- **`hr` 下 7 个一级招聘者子命令**

### Recruiter Workflow

| Command | Description |
|---------|-------------|
| `boss hr applications` | 查看候选人投递申请 |
| `boss hr candidates <keyword>` | 搜索候选人 |
| `boss hr chat` | 招聘者沟通列表 |
| `boss hr resume` | 查看/请求候选人简历 |
| `boss hr reply <friend_id> <message>` | 回复候选人消息 |
| `boss hr request-resume <friend_id> --job-id <id>` | 请求候选人附件简历 |
| `boss hr jobs list/online/offline` | 职位列表与上下线管理 |

### Discovery & Auth

| Command | Description |
|---------|-------------|
| `boss schema` | 返回全部命令的 JSON 自描述（Agent 首先调用） |
| `boss login` | 四级降级登录（Cookie → CDP → QR httpx → patchright） |
| `boss logout` | 退出登录 |
| `boss status` | 检查登录态 |
| `boss doctor` | 诊断环境、依赖、凭据完整性和网络 |
| `boss me` | 个人信息/简历/求职期望/投递记录 |

### Job Search

| Command | Description |
|---------|-------------|
| `boss search <query>` | 搜索职位（8 维筛选：城市/薪资/经验/学历/规模/行业/融资/福利） |
| `boss recommend` | 个性化推荐 |
| `boss detail <security_id>` | 职位详情（`--job-id` 走快速通道） |
| `boss show <#>` | 按编号查看上次搜索结果 |
| `boss cities` | 40 个支持城市 |

### Job Actions

| Command | Description |
|---------|-------------|
| `boss greet <sid> <jid>` | 打招呼 |
| `boss batch-greet <query>` | 批量打招呼（上限 10） |
| `boss apply <sid> <jid>` | 投递/立即沟通（幂等） |
| `boss exchange <sid>` | 交换手机/微信 |

### Communication

| Command | Description |
|---------|-------------|
| `boss chat` | 沟通列表（导出 html/md/csv/json） |
| `boss chatmsg <sid>` | 聊天消息历史 |
| `boss chat-summary <sid>` | 结构化沟通摘要（阶段/待办/风险） |
| `boss mark <sid> --label X` | 标签管理（9 种） |
| `boss interviews` | 面试邀请 |
| `boss history` | 浏览历史 |

### Pipeline & Monitoring

| Command | Description |
|---------|-------------|
| `boss pipeline` | 求职流水线（各阶段状态） |
| `boss follow-up` | 跟进提醒（超时未推进） |
| `boss digest` | 每日摘要 |
| `boss watch add/list/remove/run` | 增量监控 |
| `boss shortlist add/list/remove` | 候选池 |
| `boss preset add/list/remove` | 搜索预设 |

### Resume & AI

| Command | Description |
|---------|-------------|
| `boss resume init/list/show/edit/delete/export/import/clone/diff` | 本地简历管理 |
| `boss ai config` | 配置 AI 服务（OpenAI / Anthropic / 兼容 API） |
| `boss ai analyze-jd` | 分析岗位要求 |
| `boss ai polish` | 润色简历 |
| `boss ai optimize` | 针对岗位优化简历 |
| `boss ai suggest` | 求职建议 |
| `boss ai reply` | 招聘者消息回复草稿 |
| `boss ai interview-prep` | 基于 JD 生成模拟面试题 |
| `boss ai chat-coach` | 基于聊天记录给沟通建议 |

### System

| Command | Description |
|---------|-------------|
| `boss config list/set/reset` | 配置管理 |
| `boss clean` | 清理缓存 |
| `boss export <query>` | 导出搜索结果（CSV/JSON） |

## Agent Usage

### Step 1: Discover capabilities

```bash
boss schema
```

Returns a JSON envelope describing all 33 top-level commands, the `hr` recruiter command group, parameters, error codes, and output conventions.

### Step 2: Check auth, then act

```bash
boss status                                        # Check auth
boss search "golang" --city 杭州 --welfare "双休"    # Search with welfare filter
boss detail <security_id> --job-id <id>            # View details (fast path)
boss greet <security_id> <job_id>                  # Send greeting
boss pipeline                                      # Track progress
boss digest                                        # Daily summary
boss hr applications                               # Recruiter inbox
boss hr candidates "golang"                        # Search candidates
boss hr reply <friend_id> "你好"                   # Recruiter reply
```

### Step 3: Parse output

All commands output structured JSON to stdout:

```json
{
  "ok": true,
  "schema_version": "1.0",
  "command": "search",
  "data": [...],
  "pagination": {"page": 1, "has_more": true},
  "error": null,
  "hints": {"next_actions": ["boss detail <sid>"]}
}
```

- `ok: true` → exit code 0, `data` contains results
- `ok: false` → exit code 1, `error.code` + `error.recovery_action` for auto-recovery
- `hints.next_actions` → suggested next commands for the Agent to follow

### Error Recovery

| Error Code | Recoverable | Action |
|-----------|-------------|--------|
| AUTH_REQUIRED | Yes | `boss login` |
| AUTH_EXPIRED | Yes | `boss login` |
| TOKEN_REFRESH_FAILED | Yes | `boss login` |
| RATE_LIMITED | Yes | Wait and retry |
| ACCOUNT_RISK | Yes | Retry with CDP Chrome |
| NETWORK_ERROR | Yes | Retry |
| AI_NOT_CONFIGURED | Yes | `boss ai config` |
| AI_API_ERROR | Yes | Retry |
| AI_PARSE_ERROR | Yes | Retry |
| EXPORT_FAILED | Yes | Check dependencies |
| JOB_NOT_FOUND | No | — |
| ALREADY_GREETED | No | Skip |
| ALREADY_APPLIED | No | Skip |
| GREET_LIMIT | No | Inform user |
| INVALID_PARAM | No | Fix parameters |
| RESUME_NOT_FOUND | No | Check name |
| RESUME_ALREADY_EXISTS | No | Use different name |

## Output Conventions

- **stdout**: JSON only (structured envelope)
- **stderr**: Logs and progress (controlled by `--log-level`)
- **exit 0**: Success (`ok: true`)
- **exit 1**: Failure (`ok: false`)

## Welfare Filter (Core Feature)

`--welfare "双休,五险一金"` triggers deep inspection:
1. Check job's welfare tags first
2. If tags don't match, fetch full job description and search
3. Auto-paginate (up to 5 pages)
4. Each result includes `welfare_match` field explaining the match source

Keywords: `双休` `五险一金` `年终奖` `餐补` `住房补贴` `定期体检` `股票期权` `加班补助` `带薪年假`

## Requirements

- Python >= 3.10
- patchright + Chromium (for login; QR httpx mode works without browser)
- macOS / Linux / Windows

## Docs

- [Agent Quickstart](docs/agent-quickstart.md)
- [Agent Host Examples](docs/agent-hosts.md)
- [Capability Matrix](docs/capability-matrix.md)

## License

MIT

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

boss-agent-cli

Directory Structure

SKILL.md

Report

Notice