boss-agent-cli

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

> AI Agent 专用的 BOSS 直聘求职 CLI 工具 — 搜索、筛选、打招呼、沟通管理全流程自动化。

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

Directory Structure

Current level: tree/master/

📁 .agents/
- 📁 skills/
  - 📄 boss-agent-cli 27 B
📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.yml 806 B
  - 📄 config.yml 206 B
  - 📄 feature_request.yml 557 B
- 📁 workflows/
  - 📄 ci.yml 1.6 KB
  - 📄 release.yml 897 B
- 📄 dependabot.yml 421 B
- 📄 PULL_REQUEST_TEMPLATE.md 604 B
📁 docs/
- 📄 promotion-article.md 4.1 KB
📁 extension/
- 📄 background.js 8.5 KB
- 📄 manifest.json 550 B
- 📄 popup.html 1.1 KB
📁 mcp-server/
- 📄 README.md 1.7 KB
- 📄 server.py 6.8 KB
📁 skills/
- 📁 boss-agent-cli/
  - 📄 SKILL.md 6.3 KB
📁 src/
- 📁 boss_agent_cli/
  - 📁 api/
    
    📄 __init__.py 0 B
    
    📄 boss.yaml 4.8 KB
    
    📄 browser_client.py 9.8 KB
    
    📄 client.py 9.2 KB
    
    📄 endpoints.py 3.2 KB
    
    📄 endpoints_loader.py 1.8 KB
    
    📄 models.py 3.2 KB
    
    📄 throttle.py 1.6 KB
  - 📁 auth/
    
    📄 __init__.py 0 B
    
    📄 browser.py 5.9 KB
    
    📄 cookie_extract.py 1.5 KB
    
    📄 manager.py 4.4 KB
    
    📄 token_store.py 3.7 KB
  - 📁 bridge/
    
    📄 __init__.py 0 B
    
    📄 client.py 4.9 KB
    
    📄 daemon.py 7.4 KB
    
    📄 protocol.py 1.9 KB
  - 📁 cache/
    
    📄 __init__.py 0 B
    
    📄 store.py 2.8 KB
  - 📁 commands/
    
    📄 __init__.py 0 B
    
    📄 chat.py 7.2 KB
    
    📄 chat_export.py 10.8 KB
    
    📄 chat_snapshot.py 3.1 KB
    
    📄 chat_utils.py 877 B
    
    📄 chatmsg.py 2.7 KB
    
    📄 cities.py 545 B
    
    📄 detail.py 3.8 KB
    
    📄 doctor.py 8.1 KB
    
    📄 exchange.py 1.9 KB
    
    📄 export.py 6.6 KB
    
    📄 greet.py 6.6 KB
    
    📄 history.py 1.4 KB
    
    📄 interviews.py 1.5 KB
    
    📄 login.py 1.7 KB
    
    📄 logout.py 671 B
    
    📄 mark.py 2.6 KB
    
    📄 me.py 2.6 KB
    
    📄 recommend.py 1.7 KB
    
    📄 schema.py 12.9 KB
    
    📄 search.py 5.7 KB
    
    📄 show.py 2.6 KB
    
    📄 status.py 1.0 KB
  - 📄 __init__.py 22 B
  - 📄 config.py 484 B
  - 📄 display.py 9.1 KB
  - 📄 hooks.py 1.7 KB
  - 📄 index_cache.py 2.4 KB
  - 📄 main.py 2.5 KB
  - 📄 output.py 1.7 KB
  - 📄 search_filters.py 11.0 KB
📁 tests/
- 📄 test_api.py 2.1 KB
- 📄 test_api_client_retry.py 5.6 KB
- 📄 test_auth.py 1.5 KB
- 📄 test_auth_manager_flow.py 4.6 KB
- 📄 test_bridge.py 7.0 KB
- 📄 test_browser_client.py 3.6 KB
- 📄 test_cache.py 1.8 KB
- 📄 test_commands.py 25.8 KB
- 📄 test_display.py 3.3 KB
- 📄 test_endpoints_loader.py 1.6 KB
- 📄 test_hooks.py 2.4 KB
- 📄 test_index_cache.py 3.0 KB
- 📄 test_new_commands.py 14.4 KB
- 📄 test_output.py 2.2 KB
- 📄 test_search_filters.py 4.5 KB
- 📄 test_search_pipeline.py 5.0 KB
- 📄 test_throttle.py 1.4 KB
- 📄 test_welfare_filter.py 2.9 KB
📄 .gitattributes 119 B
📄 .gitignore 208 B
📄 CHANGELOG.md 3.5 KB
📄 CODE_OF_CONDUCT.md 1.6 KB
📄 CONTRIBUTING.md 990 B
📄 demo.gif 1.0 MB
📄 demo.tape 2.4 KB
📄 demo_showcase.py 788 B
📄 LICENSE 1.0 KB
📄 pyproject.toml 1.5 KB
📄 README.md 10.5 KB
📄 SECURITY.md 1.1 KB
📄 SKILL.md 3.6 KB
📄 uv.lock 332.5 KB

SKILL.md

# boss-agent-cli

> AI Agent 专用的 BOSS 直聘求职 CLI 工具 — 搜索、筛选、打招呼、沟通管理全流程自动化。

## Install

### Skills CLI (Recommended)

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

### Manual Install

```bash
# 克隆到 skills 目录
mkdir -p .agents/skills
git clone https://github.com/can4hou6joeng4/boss-agent-cli.git .agents/skills/boss-agent-cli

# 安装依赖
cd .agents/skills/boss-agent-cli
uv sync --all-extras
uv run patchright install chromium
```

### pip / uv tool

```bash
uv tool install boss-agent-cli
# 或
pip install boss-agent-cli
```

## Setup

```bash
# 首次登录（自动提取浏览器 Cookie，失败则扫码）
boss login

# 验证
boss status
```

## Commands

| Command | Description |
|---------|-------------|
| `boss schema` | 返回全部命令的 JSON 自描述（Agent 首先调用这个） |
| `boss login` | 登录（Cookie 提取 → CDP → 扫码三级降级） |
| `boss status` | 检查登录状态 |
| `boss search <query>` | 搜索职位（支持城市/薪资/经验/学历/行业/规模/融资/福利筛选） |
| `boss recommend` | 个性化推荐 |
| `boss detail <security_id>` | 职位详情（`--job-id` 走快速通道） |
| `boss show <#>` | 按编号查看上次搜索结果 |
| `boss greet <sid> <jid>` | 向招聘者打招呼 |
| `boss batch-greet <query>` | 搜索后批量打招呼（上限 10） |
| `boss chat` | 沟通列表（支持筛选和导出 html/md/csv/json） |
| `boss chatmsg <sid>` | 查看聊天消息历史 |
| `boss mark <sid> --label X` | 联系人标签管理（9 种标签） |
| `boss exchange <sid>` | 请求交换手机/微信 |
| `boss interviews` | 面试邀请列表 |
| `boss history` | 浏览历史 |
| `boss export <query>` | 导出搜索结果为 CSV/JSON |
| `boss cities` | 支持城市列表 |
| `boss me` | 个人信息/简历/求职期望/投递记录 |
| `boss doctor` | 环境诊断 |
| `boss logout` | 退出登录 |

## Agent Usage

### Step 1: Discover capabilities

```bash
boss schema
```

Returns a JSON envelope describing all commands, parameters, error codes, and output conventions.

### Step 2: Typical workflow

```bash
boss status                              # Check auth
boss search "golang" --city 杭州          # Search
boss detail <security_id> --job-id <id>  # View details
boss greet <security_id> <job_id>        # Send greeting
boss chat                                # View conversations
boss chatmsg <security_id>              # Read messages
```

### 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

### 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 |
| NETWORK_ERROR | Yes | Retry |
| JOB_NOT_FOUND | No | — |
| ALREADY_GREETED | No | — |
| GREET_LIMIT | No | — |

## 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`)

## Requirements

- Python >= 3.10
- Chrome browser (for login and high-risk operations)
- macOS / Linux / Windows

## License

MIT

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

boss-agent-cli

Directory Structure

SKILL.md

Report

Notice