闲鱼自动回复系统:多账号管理与智能交易解决方案

本文完全基于开源项目 xianyu-auto-reply 的官方文档编写,仅作技术分享使用。严禁商业用途,详细版权声明见文末。

为什么需要闲鱼自动化工具?

在管理多个闲鱼账号时,商家常面临三大痛点:

  1. 消息回复不及时导致客户流失
  2. 重复性发货操作消耗大量时间
  3. 多账号切换管理效率低下

本文将详细介绍一款开源的闲鱼自动化解决方案,支持:

  • 智能消息回复(关键词匹配+AI回复)
  • 全自动发货流程
  • 多账号统一管理
  • 商品数据智能分析

核心功能全景图

🔐 多用户安全系统

graph LR
A[用户注册] --> B[邮箱验证]
B --> C[图形验证码]
C --> D[JWT认证]
D --> E[数据隔离存储]
  • 安全防护三重保障

    1. 注册时邮箱+图形验证码双重验证
    2. 基于Token的会话管理
    3. 用户数据物理隔离存储

📱 多账号管理架构

graph TB
主控中心 --> 账号1[闲鱼账号A]
主控中心 --> 账号2[闲鱼账号B]
主控中心 --> 账号3[闲鱼账号N]
账号1 --> 独立任务引擎
账号2 --> 独立任务引擎
账号3 --> 独立任务引擎
  • 支持特性

    • 无限添加闲鱼账号
    • 实时监控各账号状态
    • 批量启停任务功能

🤖 智能回复系统工作流

graph LR
收到消息 --> 检查商品关键词 --> 有匹配? --> 发送专用回复
检查商品关键词 --> 无匹配? --> 检查通用关键词 --> 有匹配? --> 发送通用回复
检查通用关键词 --> 无匹配? --> AI智能生成回复

回复优先级策略

  1. 商品专用关键词回复(最高优先级)
  2. 全局通用关键词回复
  3. AI智能生成的回复

支持动态变量

"您好{用户名},您咨询的{商品名}有现货,下单后{发货时间}内发货!"

🚚 自动发货全流程

发货触发场景

  • 买家付款消息
  • 买家“小刀”议价消息
  • 其他自定义触发条件

发货机制

sequenceDiagram
买家->>系统: 付款完成
系统->>数据库: 查询商品规格
数据库-->>系统: 返回规格信息
系统->>发货规则: 匹配对应卡券
发货规则-->>系统: 返回卡密数据
系统->>买家: 自动发送卡密
系统->>闲鱼API: 确认发货

防错机制

  • 重复发货检测
  • 发货失败重试
  • 操作日志追踪

🛍️ 商品管理体系

数据获取双通道

  1. 消息触发自动采集
  2. 闲鱼API主动获取

多规格商品处理

| 商品ID | 规格名称 | 库存 | 价格 | 状态   |
|--------|----------|------|------|--------|
| 1001   | 月卡     | 50   | 15   | 启用   |
| 1001   | 季卡     | 20   | 40   | 停用   |
| 1002   | 标准版   | 100  | 10   | 启用   |

🔍 真实商品搜索技术

数据获取流程

  1. 通过Playwright启动浏览器
  2. 模拟用户搜索行为
  3. 解析真实页面数据
  4. 按“人想要”数量排序

输出结果示例

{
  "商品标题": "网易云音乐会员月卡",
  "价格": "¥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

实操指南

首次登录配置

  1. 访问 http://localhost:8080
  2. 使用默认凭证:

    • 用户名:admin
    • 密码:admin123
  3. 立即修改默认密码

添加闲鱼账号

  1. 获取闲鱼Cookie
  2. 在系统添加新账号
  3. 输入完整Cookie值
  4. 启动监控任务

配置自动发货规则

1. 进入“发货管理”界面
2. 创建新规则:
   - 商品关键词:*音乐会员*
   - 发货内容:卡密数据或API链接
3. 设置规格匹配规则
4. 启用发货延时(可选)

技术特性深度解析

🔒 安全防护体系

安全层 实现技术
认证层 JWT令牌+图形验证码
数据层 SQLite加密存储
传输层 WebSocket安全通道
操作层 完整操作日志审计

🚀 性能优化技术

  1. 异步非阻塞架构:基于asyncio的消息处理
  2. 连接池管理:数据库连接复用
  3. 智能缓存:高频数据内存缓存
  4. 资源隔离:各账号独立运行环境

🧠 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连接异常

检查步骤

  1. 防火墙开放3000-3010端口范围
  2. 验证Cookie有效性
  3. 查看实时连接日志

3. 脚本执行错误(Linux/Mac)

# 修复行结束符
sed -i 's/\r$//' docker-deploy.sh
chmod +x docker-deploy.sh
./docker-deploy.sh

4. 多规格商品匹配失败

处理策略

  1. 检查规格命名一致性
  2. 配置兜底发货规则
  3. 启用模糊匹配模式

5. 图片上传失败

解决方案

  1. 检查CDN配置参数
  2. 验证图片格式限制
  3. 查看存储空间配额

技术支持渠道

交流群组

如需技术支持,可加入开发者社区:

微信交流群
微信群二维码示意图

QQ交流群
QQ群二维码示意图


版权声明与使用条款

允许用途

  • ✅ 个人学习研究
  • ✅ 非商业技术分享
  • ✅ 开源代码贡献

禁止行为

  • ❌ 任何商业用途
  • ❌ 代码转售获利
  • ❌ 删除版权信息
  • ❌ 违法操作使用

免责声明

  1. 本项目按“现状”提供,无任何担保
  2. 使用者承担全部风险
  3. 严禁用于违法违规场景

使用本项目即代表您同意以上条款


项目致谢

本系统开发参考了以下开源项目:


项目地址:https://github.com/zhinianboke/xianyu-auto-reply
重要提示:本文所述系统仅供技术研究,使用闲鱼自动化工具需遵守平台规则