# Boss Agent Cli

> |

- **Type:** Skill
- **Install:** `agentstack add skill-1xiaoyueryuer-boss-hr-agent-toolkit-boss-agent-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [1xiaoyueryuer](https://agentstack.voostack.com/s/1xiaoyueryuer)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [1xiaoyueryuer](https://github.com/1xiaoyueryuer)
- **Source:** https://github.com/1xiaoyueryuer/boss-hr-agent-toolkit/tree/main/boss-agent-cli

## Install

```sh
agentstack add skill-1xiaoyueryuer-boss-hr-agent-toolkit-boss-agent-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# boss-agent-cli

> AI Agent 专用的 BOSS 直聘本地辅助 CLI 工具 — 34 个顶层命令，默认低风险模式聚焦本地辅助、只读优先、用户主动触发，不做自动触达、批量操作或平台数据抓取。

## Install

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

## 登录流程（双阶段策略）

**原则：** 有 Cookie 直接注入，无 Cookie 提示用户扫码。

### 第1步：检查 CLI 登录态

```bash
boss status                    # 检查 CLI 登录态
boss --role recruiter status   # 招聘者模式
```

如果返回 `logged_in: true`，说明 CLI 已有登录凭证 **→ 尝试提取 Cookie 注入到 CDP 浏览器**。

### 第2步（优先）：Cookie 注入（CLI 已登录时）

```bash
# 第一步：用 IDA 获取 Cookie
# 第二步：将 Cookie 通过 CDP add_cookies 注入浏览器
# 第三步：刷新 BOSS 页面验证是否自动登录
```

关键 Cookie 字段：`zp_at`（认证令牌）、`wt2`（登录态）、`__zp_seo_uuid__`、`bst`

注入后导航到目标页面即可，无需用户扫码。

### 第3步（兜底）：提示用户扫码（CLI 未登录 / Cookie 注入失败时）

1. **启动 CDP 浏览器：**
   ```bash
   # Windows Edge（推荐）
   "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" \
     --remote-debugging-port=9222 \
     --user-data-dir="%USERPROFILE%\.workbuddy\chrome-profiles\boss-cdp" \
     --remote-allow-origins=*
   ```

2. **打开 BOSS 登录页：**
   - 导航到 `https://www.zhipin.com/web/user/?ka=header-login`
   - **→ 明确告知用户「登录页面已打开，请扫码登录」**

3. **等待用户确认登录成功后**，再进行后续操作（JD 提取 / 简历下载等）

### 登录后验证

```bash
boss --role recruiter me                   # 验证招聘者信息
boss --role recruiter hr jobs list         # 验证可看到在线职位
```

### 常见问题

- `boss status` 可能假阳性（返回登录但实际 token 已过期），用 `boss me` 或 `boss hr jobs list` 验证更可靠
- Windows 上 PYTHONHOME 环境变量可能冲突，运行命令前加 `PYTHONHOME=""`

## Recruiter Workflow

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

## Key Commands

| Command | Description |
|---------|-------------|
| `boss schema` | 返回全部命令 JSON（Agent 首先调用） |
| `boss search ` | 搜索职位（8 维筛选） |
| `boss detail ` | 职位详情 |
| `boss hr resume  --job-id  --security-id ` | 查看候选人简历 |
| `boss login` | 四级降级登录 |
| `boss status` | 检查登录态 |
| `boss doctor` | 诊断环境 |

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

## Platform & Role

```bash
# 招聘者模式
boss --role recruiter --platform zhipin --cdp-url http://localhost:9222 

# 求职者模式（默认）
boss ... (no flags)
```

## Safety

- 不自动发消息（CLI 权限不足）
- 默认低风险模式阻断批量操作
- 候选人数据链路默认阻断敏感操作

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [1xiaoyueryuer](https://github.com/1xiaoyueryuer)
- **Source:** [1xiaoyueryuer/boss-hr-agent-toolkit](https://github.com/1xiaoyueryuer/boss-hr-agent-toolkit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-1xiaoyueryuer-boss-hr-agent-toolkit-boss-agent-cli
- Seller: https://agentstack.voostack.com/s/1xiaoyueryuer
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.