# boss-auto-apply

**Repository Path**: simonsxx/boss-auto-apply

## Basic Information

- **Project Name**: boss-auto-apply
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-05
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BOSS 直聘自动化投递工具 🤖

> 用 AI 帮你自动投 BOSS 直聘的简历。你只需要告诉 AI 你想找什么工作，它会自动帮你：读简历 → 想关键词 → 批量投递。

## 它能帮你做什么

- 📋 **自动读你的简历**：不用手动填写，AI 直接从 BOSS 直聘上读取你的在线简历
- 🧠 **自动想搜索词**：根据你的简历和工作经历，AI 帮你想出最合适的搜索关键词
- 🚀 **自动批量投递**：一个一个帮你点"立即沟通"，每个岗位之间随机等 60-120 秒，不容易被风控
- 🚫 **自动跳过不想要的**：你不想投的岗位类型（比如销售、保险）可以提前排除
- 📊 **自动记录日志**：投了哪些公司、什么结果，全部记录在 CSV 里
- 📸 **自动截图存档**：每投一个成功截图保存

## 你需要准备什么

| 条件 | 说明 |
|------|------|
| **电脑** | macOS 或 Linux（Windows 需用 WSL） |
| **浏览器** | Chrome 或 Edge，已登录 BOSS 直聘 |
| **AI 编程助手** | 推荐使用 [ZCode](https://zcode.ai)（搭载 GLM-5.2 模型），也可用 Claude Code 等 |
| **python3** | 脚本运行依赖（macOS 自带，Windows 需手动装） |

> 💡 本教程以 **ZCode + GLM-5.2 模型** 为例。用其他 AI 助手（如 Claude Code）操作类似。

---

## 📦 第一步：下载项目

### 方式一：用 git 命令下载（推荐）

打开终端，运行：

```bash
git clone https://github.com/simonsxxs/boss-auto-apply.git
cd boss-auto-apply
```

### 方式二：直接下载 ZIP

1. 打开 https://github.com/simonsxxs/boss-auto-apply
2. 点绿色的 `Code` 按钮 → `Download ZIP`
3. 解压后进入文件夹

---

## 🔧 第二步：安装 Kimi WebBridge

Kimi WebBridge 是让 AI 能控制你浏览器的工具。必须先装它，AI 才能帮你操作 BOSS 直聘。

### 2.1 安装后台程序（daemon）

打开终端，复制粘贴这行命令运行：

```bash
curl -fsSL https://kimi-web-img.moonshot.cn/webbridge/install.sh | bash
```

它会自动帮你：
- 下载 WebBridge 程序到 `~/.kimi-webbridge/`
- 启动后台服务
- 安装 AI 助手需要的 skill 文件

### 2.2 安装浏览器插件

1. 用 Chrome 或 Edge 打开这个链接：

   🔗 **https://www.kimi.com/zh-cn/features/webbridge**

2. 按页面指引安装浏览器扩展插件
3. 安装完成后，**保持浏览器打开状态**

### 2.3 检查是否安装成功

在终端运行：

```bash
~/.kimi-webbridge/bin/kimi-webbridge status
```

看到这样的输出就说明成功了：

```json
{
  "running": true,                    ← ✅ 后台程序在运行
  "extension_connected": true,        ← ✅ 浏览器插件已连接
  "port": 10086
}
```

> ⚠️ 如果 `extension_connected` 是 `false`：请确保浏览器已打开，然后重新运行上面的命令。
> 详细故障排查见 `kimi-webbridge/references/operations.md`。

---

## ⚙️ 第三步：配置你的信息

### 3.1 把投递工具放到你的工作目录

```bash
# 在你喜欢的位置创建一个工作文件夹
mkdir -p ~/job-hunt

# 把投递工具复制进去
cp -r boss-auto-apply/boss-zhipin-apply/ ~/job-hunt/

# 进入工作目录
cd ~/job-hunt/boss-zhipin-apply/
```

### 3.2 填写你的简历

```bash
# 复制简历模板
cp .claude/skills/boss-zhipin-apply/assets/resume.template.md \
   .claude/skills/boss-zhipin-apply/assets/resume.md
```

然后用文本编辑器打开 `resume.md`，把里面的 `{占位符}` 替换成你的真实信息：

```markdown
# 比如：
| 姓名 | 张三 |          ← 把 {姓名} 改成你的名字
| 邮箱 | zhangsan@qq.com |  ← 把 {your@email.com} 改成你的邮箱
| 城市 | 徐州 |          ← 把 {主要城市} 改成你想工作的城市
```

### 3.3 设置排除词（不想投的岗位）

打开 `.claude/skills/boss-zhipin-apply/references/exclude-keywords.txt`，每行写一个你不想投的关键词：

```text
销售          # 不投销售岗
保险          # 不投保险岗
主播          # 不投主播岗
直播          # 不投直播岗
# 以 # 开头的是注释，不会被读取
```

### 3.4 登录 BOSS 直聘

在浏览器里打开 https://www.zhipin.com ，确保你已登录账号。

---

## 🚀 第四步：开始使用

### 在 ZCode 中打开你的工作目录

```bash
cd ~/job-hunt/boss-zhipin-apply/
zcode .
```

### Phase 1️⃣：采集你的简历信息

在 ZCode 中对 AI 说：

> 帮我运行采集脚本，读取我的 BOSS 直聘简历和沟通列表

或者直接运行：

```bash
bash .claude/skills/boss-zhipin-apply/scripts/collect-profile.sh
```

AI 会自动：
1. 打开你的 BOSS 直聘简历页，读取简历内容
2. 打开沟通列表，读取之前联系过的招聘者
3. 把所有信息保存到 `logs/profile.json`

你会看到类似输出：

```
✓ 用户名: 张三
✓ 结构化内容获取成功
✓ 沟通列表获取成功（16 条）
✓ 已输出到 logs/profile.json
```

### Phase 2️⃣：AI 分析并确认关键词

AI 会读取 `profile.json`，分析你的简历和工作经历，然后问你：

> 你的简历期望是"操作工 9-10K 徐州"，工作经历含"销售、猎头"。你实际想投什么方向？

你回答后，AI 会帮你确定：
- **搜索关键词**：比如 `操作工,普工,质检`
- **投递城市**：比如徐州（代码 `101190800`）
- **排除词**：确认哪些岗位不投

### Phase 3️⃣：启动自动投递

确认后，AI 会帮你运行投递脚本：

```bash
bash .claude/skills/boss-zhipin-apply/scripts/run-continuous-apply.sh \
  --queries "操作工,普工" \
  --city 101190800 \
  --city-name 徐州
```

然后你就能看到 AI 自动帮你投简历了：

```
━━━ [操作工] 第 1 页 | 今日已发送 0 ━━━
采集 15 个岗位
去重+排除后可投: 12

-> 徐州光伏厂操作工质检 @ 弘元新材料
  结果: 已发送 ✅
  ⏳ 等待 108s...（模拟真人操作，防止风控）

-> 正式工五险一金 操作工 @ 嘉宏诚科技
  结果: 已发送 ✅
  ⏳ 等待 75s...
```

### Phase 4️⃣：查看投递结果

投递完成后，查看投递记录：

```bash
# 查看今日投递日志
cat logs/apply-$(date +%Y-%m-%d).csv

# 查看截图（每个成功投递都会截图）
ls screenshots/

# 运行复盘脚本，统计投递效果
python3 .claude/skills/boss-zhipin-apply/scripts/weekly_review.py 说明文档.md
```

---

## 📖 投递逻辑详解

这个工具是怎么工作的？分三个阶段：

```
Phase 1: 资料收集                Phase 2: 智能分析              Phase 3: 批量投递
┌─────────────────┐          ┌─────────────────┐          ┌─────────────────┐
│ collect-profile │    →     │  AI 分析简历     │    →     │ 自动投递循环     │
│                 │          │                 │          │                 │
│ 📋 读在线简历   │          │ 🧠 提取关键词   │          │ 🔍 打开列表页   │
│ 💬 读沟通列表   │          │ 🚫 确认排除词   │          │ 📊 筛选匹配岗位 │
│ 📄 读CSV历史   │          │ 📍 确定城市     │          │ 🖱️ 点击"沟通"  │
│                 │          │                 │          │ ⏳ 随机等待     │
│ 输出 profile.json│          │ 生成投递参数    │          │ 📸 截图存档     │
└─────────────────┘          └─────────────────┘          └─────────────────┘
```

### 投递时每一步在做什么

1. **打开职位列表**：用搜索关键词打开 BOSS 直聘列表页
2. **采集岗位**：读取当前页所有岗位卡片
3. **筛选**：跳过已投过的、含排除词的、不在目标城市的岗位
4. **逐个投递**：
   - 点击岗位卡片 → 等详情加载 → 点"立即沟通"
   - 检测是否成功（弹窗"已向BOSS发送消息"=成功）
   - 截图保存 → 关闭弹窗
5. **风控等待**：每个岗位等 60-120 秒，每 5 个额外停留 30-60 秒
6. **翻页/换关键词**：当前页投完自动翻页，关键词投完自动换下一个
7. **循环**：全部投完等 5-10 分钟重新扫描（BOSS 会刷新新岗位）
8. **自动停止**：到 145 次自动停（BOSS 上限 150 次/天）

---

## 🏙️ 城市代码速查

| 城市 | 代码 | 城市 | 代码 |
|------|------|------|------|
| 徐州 | 101190800 | 杭州 | 101210100 |
| 北京 | 101010100 | 深圳 | 101280600 |
| 上海 | 101020100 | 广州 | 101280100 |
| 苏州 | 101190400 | 成都 | 101270100 |
| 南京 | 101190100 | 武汉 | 101200100 |

> 其他城市：在 BOSS 直聘点"城市"标签 → 选城市 → 看 URL 里 `city=` 后面的数字。

---

## ⚙️ 命令参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| `--queries` | 搜索关键词，多个用逗号分隔 | `"操作工,普工,质检"` |
| `--query` | 单个搜索关键词 | `操作工` |
| `--city` | 城市代码 | `101190800` |
| `--city-name` | 城市中文名（过滤外地岗位） | `徐州` |
| `--limit` | 每天最多投几个（0=不限，到145自动停） | `50` |
| `--session` | 浏览器标签组名 | `boss` |

---

## ⚠️ 注意事项

1. **风控第一**：BOSS 直聘每天最多沟通 150 次，脚本到 145 次会自动停
2. **别手动刷新页面**：投递过程中不要手动操作浏览器，让脚本自己来
3. **遇到验证码**：脚本会自动暂停，你手动处理验证码后它会继续
4. **投递日志**：自动记录在 `logs/apply-YYYY-MM-DD.csv`，可以用 Excel 打开
5. **截图存档**：每投成功一个会截图到 `screenshots/` 目录
6. **后台运行**：长时间投递可以挂后台：
   ```bash
   nohup bash .claude/skills/boss-zhipin-apply/scripts/run-continuous-apply.sh \
     --queries "操作工,普工" --city 101190800 --city-name 徐州 \
     > logs/continuous-apply.log 2>&1 &
   ```

---

## 🔧 故障排查

| 问题 | 解决方案 |
|------|----------|
| `extension_connected: false` | 打开浏览器，确保 WebBridge 扩展已启用 |
| `未到达简历页` | 确认 BOSS 直聘已登录，重新运行脚本 |
| `触发风控，暂停 10 分钟` | 正常现象，等 10 分钟后自动恢复 |
| 脚本卡住不动 | 检查浏览器是否被手动关闭，重新运行 |
| 选择器失效 | BOSS 改版了，参考 `references/selectors.md` 的探测方法 |

更多故障排查见 `boss-zhipin-apply/.claude/skills/boss-zhipin-apply/references/troubleshooting.md`。

---

## 📁 项目结构

```
boss-auto-apply/
├── README.md                          ← 你正在看的这个文件
├── kimi-webbridge/                    ← Kimi WebBridge（浏览器接管工具）
│   ├── SKILL.md                       ← API 文档
│   ├── references/operations.md       ← 安装和诊断指南
│   └── scripts/screenshot.sh          ← 截图脚本
└── boss-zhipin-apply/                 ← BOSS 直聘投递工具
    ├── README.md                      ← 工具详细说明
    ├── 说明文档.md                     ← 项目管理文档（填你的信息）
    ├── .gitignore                     ← Git 忽略规则
    ├── logs/                          ← 投递日志（自动生成）
    └── .claude/skills/boss-zhipin-apply/
        ├── SKILL.md                   ← Skill 主文档（AI 读这个来了解怎么投）
        ├── README.md
        ├── references/                ← 筛选规则、DOM选择器、故障排查、话术模板
        ├── assets/                    ← 简历模板、说明文档模板
        ├── evals/                     ← 测试用例
        └── scripts/                  ← 核心脚本
            ├── collect-profile.sh     ← Phase 1: 采集简历+沟通列表
            ├── run-continuous-apply.sh ← Phase 3: 持续投递（主脚本）
            ├── apply-list.sh          ← 批量投递（旧版）
            ├── batch-apply.sh         ← 批量投递辅助
            ├── screenshot-verify.sh   ← 截图验证
            └── weekly_review.py       ← 数据复盘
```

---

## 📜 License

MIT License - 随便用，不负责。

---

## 作者

**simon**，一个不懂代码的AI极客

- 微信交流群：simonsxxs
- GitHub：https://github.com/simonsxxs
- Gitee：https://gitee.com/simonsxx