项目简介
这是一个基于 Playwright 和 AI 的闲鱼多任务实时监控工具，提供完整的 Web 管理界面。它能帮你全天候监控目标商品，利用 AI 自动过滤掉不靠谱的卖家和商品，只推送真正值得购买的好货。
核心特性
- Web 可视化管理: 任务管理、账号管理、AI 标准编辑、运行日志、结果浏览
- AI 驱动: 自然语言创建任务，多模态模型深度分析商品
- 多任务并发: 独立配置关键词、价格、筛选条件和 AI Prompt
- 高级筛选: 包邮、新发布时间范围、省/市/区三级区域筛选
- 即时通知: 支持 ntfy.sh、企业微信、Bark、Telegram、Webhook
- 定时调度: Cron 表达式配置周期性任务
- 账号与代理轮换: 多账号管理、任务绑定账号、代理池轮换与失败重试
- Docker 部署: 一键容器化部署
截图
快速开始
环境准备
要求:
- Python 3.10+
- Node.js + npm（用于前端构建）
- Playwright 浏览器依赖（未安装时执行
playwright install chromium）
git clone https://github.com/Usagi-org/ai-goofish-monitor
cd ai-goofish-monitor
配置
- 创建配置文件
cp .env.example .env
-
| 核心配置项 |
变量 |
说明 |
必填 |
OPENAI_API_KEY |
AI 模型 API Key |
是 |
OPENAI_BASE_URL |
API 接口地址（兼容 OpenAI 格式） |
是 |
OPENAI_MODEL_NAME |
多模态模型名称（如 gpt-4o） |
是 |
WEB_USERNAME / WEB_PASSWORD |
Web 界面登录凭据（默认 admin / admin123） |
否 |
NTFY_TOPIC_URL |
ntfy.sh 通知地址 |
否 |
BARK_URL |
Bark 推送地址 |
否 |
WX_BOT_URL |
企业微信 Webhook（需用双引号包围） |
否 |
完整配置项参考 .env.example
- 启动服务
chmod +x start.sh && ./start.sh
start.sh 会自动完成依赖安装、前端构建与后端启动。
- 访问 Web UI
访问 http://127.0.0.1:8000，登录默认密码(admin/admin123) → 闲鱼账号管理，按提示使用 Chrome 扩展 提取并粘贴登录状态 JSON。 账号会保存到 state/ 目录（例如 state/acc_1.json）。随后在任务管理中选择绑定账号即可开始使用。
🐳 Docker 部署
使用 docker-compose.yaml 一键启动，镜像已预置前端构建与运行环境。
1) 准备(这一步可跳过，启动后在UI页面里也可以配置)
cp .env.example .env
vim .env
2) 启动
docker compose up -d
3) 访问与管理
- 访问 Web UI:
http://127.0.0.1:8000
- 查看日志:
docker compose logs -f app
- 停止服务:
docker compose down
账号状态默认保存在容器内 /app/state，如需持久化可在 compose 中添加挂载 ./state:/app/state。
4) 更新镜像
docker compose pull
docker compose up -d
Web UI 功能一览
- 任务管理：AI 创建、参数编辑、任务调度、账号绑定
- 闲鱼账号管理：添加/更新/删除账号，导入登录状态 JSON
- 结果查看：卡片浏览、筛选排序、详情查看
- 运行日志：按任务分组、增量加载、自动刷新
- 系统设置：状态检查、Prompt 编辑、代理轮换
🚀 工作流程
下图描述了单个监控任务从启动到完成的核心处理逻辑。在实际使用中，src.app 会作为主服务，根据用户操作或定时调度来启动一个或多个任务进程。
graph TD
A[启动监控任务] --> B[选择账号/代理配置];
B --> C[任务: 搜索商品];
C --> D{发现新商品?};
D -- 是 --> E[抓取商品详情 & 卖家信息];
E --> F[下载商品图片];
F --> G[调用AI进行分析];
G --> H{AI是否推荐?};
H -- 是 --> I[发送通知];
H -- 否 --> J[保存记录到 JSONL];
I --> J;
D -- 否 --> K[翻页/等待];
K --> C;
J --> C;
C --> L{触发风控/异常?};
L -- 是 --> M[账号/代理轮换并重试];
M --> C;
Web 界面认证
认证配置
Web界面已启用Basic认证保护，确保只有授权用户才能访问管理界面和API。
配置方法
在 .env 文件中设置认证凭据：
# Web服务认证配置
WEB_USERNAME=admin
WEB_PASSWORD=admin123
默认凭据
如果未在 .env 文件中设置认证凭据，系统将使用以下默认值：
⚠️ 重要：生产环境请务必修改默认密码！
认证范围
- 需要认证：所有API端点、Web界面、静态资源
- 无需认证：健康检查端点 (
/health)
使用方法
- 浏览器访问：访问Web界面时会弹出认证对话框
- API调用：需要在请求头中包含Basic认证信息
- 前端JavaScript：会自动处理认证，无需修改
安全建议
- 修改默认密码为强密码
- 生产环境使用HTTPS协议
- 定期更换认证凭据
- 通过防火墙限制访问IP范围
项目地址
项目源码与最新文档：https://github.com/Usagi-org/ai-goofish-monitor/blob/master/README.md
本文介绍的工具整合了 Python 自动化、AI 分析与 Docker部署，非常适合需要自动化监控电商平台的开发者。如果你对这类开源实战项目感兴趣，欢迎在云栈社区的对应板块交流探讨。 | 
发表于 昨天 19:41
|
查看: 1|
回复: 0
