xianyu-auto-reply 是一个基于 Python + FastAPI 的开源自动化客服工具，专为闲鱼平台设计，支持多用户/多账号管理、智能回复（关键词/AI）、自动确认发货、商品管理/搜索和系统监控，通过 WebSocket 实时连接闲鱼服务器，实现高效店铺自动化运营，适用于个人/小团队闲鱼卖家。

功能速览

• 多用户系统：邮箱验证码注册/登录，数据隔离/权限管理/JWT 认证，防暴力/会话/日志。
• 多账号管理：无限账号/独立运行/实时状态/批量操作。
• 智能回复：关键词匹配（准确和模糊匹配），支持针对特定商品设定专门回复内容，支持通用关键词与默认回复；还集成 AI 回复（如 OpenAI、通义千问等），回复内容可带变量替换（如用户名、商品信息等）。
• 自动发货：支持虚拟商品发货：根据商品关键词匹配规则发放“卡密”或发货内容；支持延时发货、自动确认发货、防重复发货等机制；支持图片发货；支持不同规格商品的发货规则。
• 商品管理：自动收集消息中提到的商品信息；支持获取商品详情；可以批量管理商品； 支持多规格商品的规格信息管理；支持批量查看、编辑、切换多规格状态；智能去重。
• 商品搜索：借助 Playwright 做真实的闲鱼页面抓取；支持分页、多页搜索；支持排序（例如按“人想要”数目排序）和筛选商品详情显示。
• 系统监控：实时日志/性能/健康检查/数据备份/恢复。
• 通知系统：QQ、钉钉、飞书、Bark、邮件、微信、Telegram等8种通知方式。

安装与使用

1.环境准备

• Python >= 3.11
• Node.js >= 16（用于前端 / JavaScript 功能）
• Docker + Docker Compose（如果使用容器部署）
• 推荐：2GB+ 内存，10GB 以上存储空间以保存日志／数据／图片等。

2.部署方式

多种部署选项：

• Docker 一键部署：使用预构建镜像，挂载数据目录，然后启动容器。 
• 源码部署：克隆仓库 → 创建虚拟环境 → 安装依赖（requirements.txt） → 安装 Playwright 浏览器依赖（如果商品搜索等功能用到）。 
• 使用提供的脚本（Linux/macOS 的 .sh，Windows 的 .bat）来启动和管理。

3.系统配置

• 修改全局配置文件（global_config.yml）以设定 WebSocket 参数、API /端口／访问设置／安全设置等。
• 初次启动系统登录界面（默认账号可能是 admin / admin123 ，应当先修改密码）。

4.使用流程

• 注册用户 → 登录系统；
• 添加闲鱼账号：输入闲鱼账号ID、Cookie 等信息 → 系统启动监控任务；
• 配置自动回复规则：关键词／商品专属关键词／通用关键词／默认回复／AI 回复；
• 配置自动发货规则：设定哪些商品用哪种发货方式、延时发货、发货内容或卡密等；
• 使用商品搜索功能（输入关键词，系统自动抓取闲鱼商品数据）；
• 查看日志／监控状态／系统健康 /性能 /消息状态等。

系统适合以下用户／场景：

• 闲鱼商家或闲鱼卖家，希望能自动化处理客服消息／回复规则，减轻人工回复负担。
• 想自动化发货虚拟商品（如卡密／电子凭证等），并在付款后自动确认／发货，提高效率。
• 多账号管理或代理型卖家，需要同时管理多个闲鱼账号任务。
• 具备必定技术能力或者有服务器／VPS，可部署 Docker／源码环境的用户。

项目信息速览

• 项目地址：https://github.com/zhinianboke/xianyu-auto-reply
• 开发者：zhinianboke
• Stars / Forks：2K/613