闲鱼自动回复系统:多账号管理与智能交易解决方案
本文完全基于开源项目 xianyu-auto-reply 的官方文档编写,仅作技术分享使用。严禁商业用途,详细版权声明见文末。
为什么需要闲鱼自动化工具?
在管理多个闲鱼账号时,商家常面临三大痛点:
- 
消息回复不及时导致客户流失  - 
重复性发货操作消耗大量时间  - 
多账号切换管理效率低下  
本文将详细介绍一款开源的闲鱼自动化解决方案,支持:
- 
智能消息回复(关键词匹配+AI回复)  - 
全自动发货流程  - 
多账号统一管理  - 
商品数据智能分析  
核心功能全景图
🔐 多用户安全系统
graph LR
A[用户注册] --> B[邮箱验证]
B --> C[图形验证码]
C --> D[JWT认证]
D --> E[数据隔离存储]
- 
安全防护三重保障: - 
注册时邮箱+图形验证码双重验证  - 
基于Token的会话管理  - 
用户数据物理隔离存储  
 - 
 
📱 多账号管理架构
graph TB
主控中心 --> 账号1[闲鱼账号A]
主控中心 --> 账号2[闲鱼账号B]
主控中心 --> 账号3[闲鱼账号N]
账号1 --> 独立任务引擎
账号2 --> 独立任务引擎
账号3 --> 独立任务引擎
- 
支持特性: - 
无限添加闲鱼账号  - 
实时监控各账号状态  - 
批量启停任务功能  
 - 
 
🤖 智能回复系统工作流
graph LR
收到消息 --> 检查商品关键词 --> 有匹配? --> 发送专用回复
检查商品关键词 --> 无匹配? --> 检查通用关键词 --> 有匹配? --> 发送通用回复
检查通用关键词 --> 无匹配? --> AI智能生成回复
回复优先级策略:
- 
商品专用关键词回复(最高优先级)  - 
全局通用关键词回复  - 
AI智能生成的回复  
支持动态变量:
"您好{用户名},您咨询的{商品名}有现货,下单后{发货时间}内发货!"
🚚 自动发货全流程
发货触发场景:
- 
买家付款消息  - 
买家“小刀”议价消息  - 
其他自定义触发条件  
发货机制:
sequenceDiagram
买家->>系统: 付款完成
系统->>数据库: 查询商品规格
数据库-->>系统: 返回规格信息
系统->>发货规则: 匹配对应卡券
发货规则-->>系统: 返回卡密数据
系统->>买家: 自动发送卡密
系统->>闲鱼API: 确认发货
防错机制:
- 
重复发货检测  - 
发货失败重试  - 
操作日志追踪  
🛍️ 商品管理体系
数据获取双通道:
- 
消息触发自动采集  - 
闲鱼API主动获取  
多规格商品处理:
| 商品ID | 规格名称 | 库存 | 价格 | 状态   |
|--------|----------|------|------|--------|
| 1001   | 月卡     | 50   | 15   | 启用   |
| 1001   | 季卡     | 20   | 40   | 停用   |
| 1002   | 标准版   | 100  | 10   | 启用   |
🔍 真实商品搜索技术
数据获取流程:
- 
通过Playwright启动浏览器  - 
模拟用户搜索行为  - 
解析真实页面数据  - 
按“人想要”数量排序  
输出结果示例:
{
  "商品标题": "网易云音乐会员月卡",
  "价格": "¥8.99",
  "想要人数": 2450,
  "卖家位置": "上海",
  "商品链接": "https://..."
}
技术架构解析
系统架构图
graph TD
A[Web界面] --> B[FastAPI服务]
B --> C[Cookie管理器]
C --> D[账号1 WS连接]
C --> E[账号2 WS连接]
D --> F[消息处理器]
E --> F
F --> G[SQLite数据库]
核心模块说明
| 模块文件 | 功能描述 | 
|---|---|
Start.py | 
系统启动入口 | 
XianyuAutoAsync.py | 
WebSocket核心处理 | 
reply_server.py | 
Web服务接口 | 
db_manager.py | 
多用户数据库管理 | 
ai_reply_engine.py | 
智能回复引擎 | 
item_search.py | 
商品搜索实现 | 
部署指南(三种方式)
方案一:Docker极速部署
# 创建数据目录
mkdir -p xianyu-auto-reply
# 启动容器
docker run -d \
  -p 8080:8080 \
  -v $PWD/xianyu-auto-reply/:/app/data/ \
  --name xianyu-auto-reply \
  registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0
Windows用户替换$PWD为%cd%
方案二:源码构建部署
git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply
chmod +x docker-deploy.sh  # Linux/macOS
./docker-deploy.sh
Windows用户使用docker-deploy.bat
方案三:本地开发环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate    # Windows
pip install -r requirements.txt
playwright install chromium
python Start.py
实操指南
首次登录配置
- 
访问 http://localhost:8080 - 
使用默认凭证: - 
用户名: admin - 
密码: admin123 
 - 
 - 
立即修改默认密码  
添加闲鱼账号
- 
获取闲鱼Cookie  - 
在系统添加新账号  - 
输入完整Cookie值  - 
启动监控任务  
配置自动发货规则
1. 进入“发货管理”界面
2. 创建新规则:
   - 商品关键词:*音乐会员*
   - 发货内容:卡密数据或API链接
3. 设置规格匹配规则
4. 启用发货延时(可选)
技术特性深度解析
🔒 安全防护体系
| 安全层 | 实现技术 | 
|---|---|
| 认证层 | JWT令牌+图形验证码 | 
| 数据层 | SQLite加密存储 | 
| 传输层 | WebSocket安全通道 | 
| 操作层 | 完整操作日志审计 | 
🚀 性能优化技术
- 
异步非阻塞架构:基于asyncio的消息处理  - 
连接池管理:数据库连接复用  - 
智能缓存:高频数据内存缓存  - 
资源隔离:各账号独立运行环境  
🧠 AI智能回复配置
# 配置示例
ai_engine: openai
api_key: sk-xxxxxxxxxxxx
model: gpt-4
temperature: 0.7
max_tokens: 500
支持模型:
- 
OpenAI GPT系列  - 
通义千问  - 
其他兼容API的模型  
常见问题解决方案
1. Docker容器启动失败
# 清理并重建容器
docker-compose down
docker rm xianyu-auto-reply
docker-compose up -d --build
2. WebSocket连接异常
检查步骤:
- 
防火墙开放3000-3010端口范围  - 
验证Cookie有效性  - 
查看实时连接日志  
3. 脚本执行错误(Linux/Mac)
# 修复行结束符
sed -i 's/\r$//' docker-deploy.sh
chmod +x docker-deploy.sh
./docker-deploy.sh
4. 多规格商品匹配失败
处理策略:
- 
检查规格命名一致性  - 
配置兜底发货规则  - 
启用模糊匹配模式  
5. 图片上传失败
解决方案:
- 
检查CDN配置参数  - 
验证图片格式限制  - 
查看存储空间配额  
技术支持渠道
交流群组
如需技术支持,可加入开发者社区:
微信群二维码示意图
QQ群二维码示意图
版权声明与使用条款
允许用途
- 
✅ 个人学习研究  - 
✅ 非商业技术分享  - 
✅ 开源代码贡献  
禁止行为
- 
❌ 任何商业用途  - 
❌ 代码转售获利  - 
❌ 删除版权信息  - 
❌ 违法操作使用  
免责声明
- 
本项目按“现状”提供,无任何担保  - 
使用者承担全部风险  - 
严禁用于违法违规场景  
使用本项目即代表您同意以上条款
项目致谢
本系统开发参考了以下开源项目:
- 
XianYuApis – 闲鱼API实现  - 
XianyuAutoAgent – 自动化框架  - 
myfish – 扫码登录方案  
项目地址:https://github.com/zhinianboke/xianyu-auto-reply
重要提示:本文所述系统仅供技术研究,使用闲鱼自动化工具需遵守平台规则
