171 lines
2.9 KiB
Markdown
171 lines
2.9 KiB
Markdown
|
# 小红书登录后端服务
|
|||
|
|
|
|||
|
|
基于 Playwright 的小红书登录服务，支持手机号+验证码登录。
|
|||
|
|
|
|||
|
|
## 功能特性
|
|||
|
|
|
|||
|
|
- ✅ 手机号+验证码登录
|
|||
|
|
- ✅ 自动化浏览器操作
|
|||
|
|
- ✅ 获取登录后的 Cookies 和用户信息
|
|||
|
|
- ✅ RESTful API 接口
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
- Python 3.8+
|
|||
|
|
- FastAPI - Web 框架
|
|||
|
|
- Playwright - 浏览器自动化
|
|||
|
|
- Uvicorn - ASGI 服务器
|
|||
|
|
|
|||
|
|
## 安装步骤
|
|||
|
|
|
|||
|
|
### 1. 创建虚拟环境（如果还没有）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd backend
|
|||
|
|
python -m venv venv
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 激活虚拟环境
|
|||
|
|
|
|||
|
|
**Windows:**
|
|||
|
|
```bash
|
|||
|
|
venv\Scripts\activate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Linux/Mac:**
|
|||
|
|
```bash
|
|||
|
|
source venv/bin/activate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 安装 Playwright 浏览器
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
playwright install chromium
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 使用方法
|
|||
|
|
|
|||
|
|
### 启动服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python main.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
服务将在 `http://localhost:8000` 启动。
|
|||
|
|
|
|||
|
|
### API 接口
|
|||
|
|
|
|||
|
|
#### 1. 发送验证码
|
|||
|
|
|
|||
|
|
**POST** `/api/xhs/send-code`
|
|||
|
|
|
|||
|
|
请求体:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"phone": "13800138000",
|
|||
|
|
"country_code": "+86"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
响应:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"message": "验证码已发送，请在小红书APP中查看",
|
|||
|
|
"data": {
|
|||
|
|
"sent_at": "2025-12-10T10:00:00"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 2. 登录验证
|
|||
|
|
|
|||
|
|
**POST** `/api/xhs/login`
|
|||
|
|
|
|||
|
|
请求体:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"phone": "13800138000",
|
|||
|
|
"code": "123456",
|
|||
|
|
"country_code": "+86"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
响应:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"message": "登录成功",
|
|||
|
|
"data": {
|
|||
|
|
"user_info": {...},
|
|||
|
|
"cookies": {...},
|
|||
|
|
"login_time": "2025-12-10T10:01:00"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 3. 健康检查
|
|||
|
|
|
|||
|
|
**GET** `/`
|
|||
|
|
|
|||
|
|
响应:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"status": "ok",
|
|||
|
|
"message": "小红书登录服务运行中"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. **滑块验证**: 小红书可能会要求滑块验证，需要手动完成
|
|||
|
|
2. **验证码**: 验证码会发送到小红书 APP，需要在 APP 中查看
|
|||
|
|
3. **浏览器模式**:
|
|||
|
|
- 开发时使用 `headless=False` 可以看到浏览器操作
|
|||
|
|
- 生产环境可设置 `headless=True` 在后台运行
|
|||
|
|
4. **反爬虫**: 小红书有反爬虫机制，可能需要调整策略
|
|||
|
|
|
|||
|
|
## 开发调试
|
|||
|
|
|
|||
|
|
### 查看 API 文档
|
|||
|
|
|
|||
|
|
访问 `http://localhost:8000/docs` 可以看到自动生成的 Swagger 文档。
|
|||
|
|
|
|||
|
|
### 日志输出
|
|||
|
|
|
|||
|
|
服务会在控制台输出详细的操作日志，便于调试。
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
backend/
|
|||
|
|
├── main.py # FastAPI 主程序
|
|||
|
|
├── xhs_login.py # 小红书登录服务
|
|||
|
|
├── requirements.txt # Python 依赖
|
|||
|
|
├── venv/ # Python 虚拟环境
|
|||
|
|
└── README.md # 说明文档
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
### Q: 验证码发送失败？
|
|||
|
|
A: 检查手机号格式是否正确，确保网络连接正常。
|
|||
|
|
|
|||
|
|
### Q: 登录失败？
|
|||
|
|
A: 确认验证码是否正确，验证码有时效性，请及时输入。
|
|||
|
|
|
|||
|
|
### Q: 浏览器无法启动？
|
|||
|
|
A: 确保已经运行 `playwright install chromium` 安装浏览器。
|
|||
|
|
|
|||
|
|
## 安全提示
|
|||
|
|
|
|||
|
|
- 不要在公网暴露此服务
|
|||
|
|
- 生产环境建议添加认证机制
|
|||
|
|
- 妥善保管获取到的 Cookies 和用户信息
|