e4f846c2cb6ea57e60257de72edf4ebce3fb2ae6
Boss直聘 AI 智能投递系统
基于 AdsPower 指纹浏览器 + Playwright + AI 大模型 的客户端-服务端架构自动求职投递系统。 支持多用户数据隔离,每个客户端以机器硬件指纹作为唯一编码注册。
系统架构
┌──────────────────────────────────────────────┐
│ Python 客户端(本地 Windows) │
│ · 本地 Web 控制面板(浏览器打开操作) │
│ · AdsPower 指纹浏览器 + Playwright 自动化 │
│ · 机器硬件指纹 → 唯一编码 │
└────────────────────┬─────────────────────────┘
│ HTTP + JWT Token
▼
┌──────────────────────────────────────────────┐
│ FastAPI 服务端(云服务器) │
│ · 用户注册 / JWT 认证 │
│ · 简历管理(主简历标记) │
│ · 投递会话 + 投递记录(按 user_id 隔离) │
└────────────────────┬─────────────────────────┘
▼
MySQL 数据库
业务流程
- 连接:客户端用机器指纹注册云端,获取 Token
- 登录:面板引导,通过 AdsPower 打开 Boss直聘,用户手动登录
- 简历:AI 自动抓取账号内所有简历 → 用户勾选主简历
- 投递:设置城市/薪资/关键词 → 点击开始,AI 按主简历匹配 JD 自动投递
- 记录:实时查看进度、历史与统计,随时结束
目录结构
jianli-boss/
├── server/ # 云端服务端(FastAPI + MySQL)
│ ├── main.py # 服务入口
│ ├── config.py # 配置(读 .env)
│ ├── database.py # MySQL 连接
│ ├── models.py # ORM 模型
│ ├── schemas.py # Pydantic 模式
│ ├── auth.py # JWT 认证
│ ├── routers/ # API 路由
│ │ ├── register.py # 注册 / 登录状态
│ │ ├── resumes.py # 简历管理
│ │ ├── sessions.py # 投递会话
│ │ └── jobs.py # 投递记录
│ ├── requirements.txt
│ └── .env.example
│
└── client/ # 本地客户端
├── main.py # 客户端入口(启动 Web 面板)
├── config.py # 配置(读 .env)
├── fingerprint.py # 机器硬件指纹
├── server_api.py # 调用云端 API
├── ai.py # AI 评分 / 简历整理
├── browser/
│ ├── manager.py # AdsPower + Playwright 管理
│ ├── resume_scraper.py # 抓取简历
│ └── applicant.py # 投递自动化(可启停)
├── web/
│ ├── app.py # 本地控制面板后端
│ ├── templates/index.html
│ └── static/ # style.css / app.js
├── requirements.txt
└── .env.example
一、部署服务端(云服务器)
1. 准备 MySQL
CREATE DATABASE jianli_boss DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
2. 安装依赖
cd server
pip install -r requirements.txt
cp .env.example .env # 编辑 .env 填写数据库密码和 SECRET_KEY
3. 启动
# 开发模式
uvicorn server.main:app --host 0.0.0.0 --port 8000 --reload
# 生产模式(建议用 gunicorn + uvicorn worker,或配 Nginx 反代 + HTTPS)
uvicorn server.main:app --host 0.0.0.0 --port 8000 --workers 4
启动后访问 http://服务器IP:8000/docs 可查看自动生成的 API 文档(Swagger)。
⚠️ 生产环境务必修改
.env中的SECRET_KEY,并建议通过 Nginx 配置 HTTPS。
二、运行客户端(本地 Windows)
1. 安装 AdsPower
- 前往 adspower.net 下载安装
- 创建一个浏览器 Profile,记住它的 用户 ID
2. 安装依赖
cd client
pip install -r requirements.txt
playwright install chromium
3. 配置环境变量
复制 .env.example 为 .env 并填写:
SERVER_URL=http://你的服务器IP:8000 # 云端服务端地址
ADSPOWER_USER_ID=你的ProfileID # AdsPower 用户 ID(必填)
AI_API_KEY=你的大模型Key # AI 评分用
AI_BASE_URL=https://api.deepseek.com # OpenAI 兼容接口
AI_MODEL=deepseek-chat
4. 启动
# 确保 AdsPower 软件已打开
python -m client.main
浏览器会自动打开控制面板 http://127.0.0.1:8088,按 5 个步骤操作即可。
三、关于中文乱码
所有文件读写均已指定 encoding="utf-8"。若 PowerShell 控制台仍乱码,运行:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
chcp 65001
常见问题
| 问题 | 解决方案 |
|---|---|
| 客户端连不上服务端 | 检查 SERVER_URL 是否正确、云服务器安全组是否放行端口 |
| 注册一直失败 | 确认服务端已启动且 MySQL 可连接 |
| 无法打开浏览器 | 确认 AdsPower 已运行且 ADSPOWER_USER_ID 正确 |
| 抓不到简历 | 确认已登录 Boss直聘;页面结构变化时需调整 resume_scraper.py 选择器 |
| AI 评分不生效 | 检查 AI_API_KEY 是否配置,AI_BASE_URL/AI_MODEL 是否匹配 |
| 投递按钮找不到 | Boss直聘 前端改版,需更新 applicant.py 中的选择器 |
安全与合规提示
- 请遵守 Boss直聘 的用户协议,控制投递频率(建议每天 ≤30 个),避免账号风险
SECRET_KEY、数据库密码、AI Key 等敏感信息请勿提交到代码仓库- 建议将
.env、.token、logs/加入.gitignore
Languages
Python
78.4%
HTML
13.1%
JavaScript
6%
CSS
2.1%
Batchfile
0.3%
Other
0.1%