跳到主要内容
项目档案应用项目

闲鱼商品智能监控系统:基于 Playwright 与 AI 的多任务监控工具 - 包含 Docker 部署、Web 管理界面及详细使用教程

ai-goofish-monitor 是一个基于 Playwright 和 AI 的闲鱼商品智能监控工具,支持多任务并发、AI 深度分析、区域筛选和即时通知。适用于买家高效寻找心仪商品,提供 Docker 一键部署和完整的 Web 管理界面。本页面包含项目介绍、安装步骤、配置方法和使用教程。

14,357PythonStar 于 2026年4月4日2026年9月19日 更新

AI 总结

ai-goofish-monitor 是一个基于 Playwright 与 AI 的闲鱼商品智能监控系统,支持多任务并发、AI 深度分析与 Web 可视化管理,帮助买家高效从海量闲鱼商品中筛选出心仪目标。

中文项目介绍

ai-goofish-monitor 是一个基于 Playwright 和 AI 模型的闲鱼商品智能监控系统,配备完整的 Web 管理后台。它旨在解决闲鱼平台商品数量庞大、手动筛选效率低下的问题,通过自动化实时监控与 AI 智能分析,帮助用户快速定位符合特定需求的商品。 系统支持多任务并发监控,每个任务可独立配置关键词、价格范围、筛选条件和 AI 提示词。用户可通过自然语言描述需求,由 AI 自动生成分析标准;也可使用关键词规则直接创建任务。此外,还提供区域筛选(省/市/区三级)、定时调度(Cron 表达式)、多账号管理、代理轮换与失败重试等功能。 适用场景包括:买家设置商品监控任务并接收新上架商品通知;使用 AI 分析商品图片和描述以评估质量或真伪;定时周期性抓取特定关键词或区域的商品;管理多个闲鱼账号并分配任务;通过 Web 界面集中管理任务、查看历史结果和运行日志。 技术实现上,后端采用 FastAPI,前端为 Vue 3 + TypeScript + Vite,爬虫基于 Playwright,AI 集成 OpenAI 兼容接口,数据存储使用 SQLite,任务调度依赖 apscheduler。支持 Docker 容器化部署,内置 Chromium,无需宿主机额外安装浏览器。

详细信息与使用说明

1. 项目定位与用途

ai-goofish-monitor 是一个基于 Playwright 与 AI 的闲鱼商品智能监控系统,提供完整的 Web 管理界面。其核心定位是帮助买家从闲鱼海量商品中高效筛选出符合特定需求的目标。系统支持多任务并发监控,每个任务可独立配置关键词、价格、区域和 AI 分析标准;通过自然语言描述需求,AI 可自动生成分析规则,实现智能化商品筛选。同时,系统提供任务调度、即时通知、多账号代理轮换等功能,适用于个人或小团队进行闲鱼商品监控。

2. 解决的问题

闲鱼平台商品数量庞大且更新频繁,手动浏览筛选效率极低,且难以持续跟踪新上架商品。本项目通过自动化爬虫实时监控商品列表,结合 AI 多模态分析(文本与图片)评估商品质量与匹配度,解决人工筛选的耗时与主观性问题。此外,系统通过多账号轮换、代理池和失败重试机制应对闲鱼风控,确保监控稳定性;通过多渠道即时通知(如 ntfy、企业微信等)让用户第一时间获取心仪商品信息。

3. 适用场景

主要适用于需要从闲鱼寻找特定商品的买家:1) 设置关键词监控,获取新发布商品通知;2) 使用 AI 分析商品图片和描述,判断真伪或质量(如二手电子产品、奢侈品);3) 定时周期性抓取特定区域或价格区间的商品;4) 管理多个闲鱼账号,分配不同监控任务并轮换代理以避免封禁;5) 通过 Web 界面集中管理所有任务、查看历史结果和运行日志,实现系统化寻物。

4. 安装方式

推荐使用 Docker Compose 一键部署:首先克隆仓库 git clone https://github.com/Usagi-org/ai-goofish-monitor 并进入目录;复制环境配置模板 cp .env.example .env;编辑 .env 文件填写必填配置(如 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL_NAME);运行 docker compose up -d 启动服务。默认 Web UI 地址为 http://127.0.0.1:8000。Docker 镜像已内置 Chromium,无需宿主机安装浏览器。若镜像下载慢,可使用国内镜像加速。此外,也支持本地开发环境启动:需 Python 3.10+ 和 Node.js,安装依赖后执行 ./start.sh 或手动启动前后端。

5. 使用方式

首次使用需登录 Web UI(默认 admin/admin123),在账号管理页面通过 Chrome 扩展导出闲鱼登录态 JSON 并导入,登录态保存至 state/ 目录。然后在任务管理页面创建任务:选择 AI 模式(填写详细需求,后台生成分析标准)或关键词模式(直接填写规则),配置价格、区域、定时等参数并绑定账号。任务运行后,在结果页面查看匹配商品,系统会根据配置推送通知至 ntfy、企业微信等渠道。日志页面可监控任务运行状态和排查问题。

6. 补充说明与实现特点

数据存储方面,主数据库为 SQLite(默认 data/app.sqlite3),存储任务、结果和价格历史;文件系统目录如 state/(登录态)、logs/(日志)、images/(商品图片)独立存储。应用启动时会自动建库并尝试从旧 config.json 等导入历史数据。配置通过 .env 文件管理,支持代理设置、AI 调试模式等。开发环境下,前端基于 Vue 3 + Vite,后端为 FastAPI,测试使用 pytest。系统支持 Cron 表达式定时任务,区域筛选数据基于闲鱼页面快照内置。注意:Docker 部署时必须设置 RUN_HEADLESS=true。

思维导图

ai-goofish-monitor
Web 管理界面
任务管理
账号管理
结果查看
系统设置
后端服务
FastAPI 应用
API 路由
WebSocket
爬虫引擎
Playwright 驱动
页面解析
登录态管理
AI 分析
OpenAI 集成
多模态分析
Prompt 管理
任务调度
Cron 表达式
apscheduler
任务队列
通知模块
ntfy
企业微信
Bark
Telegram
Webhook
数据存储
SQLite 数据库
文件系统存储

常见问题

如何部署 ai-goofish-monitor?

推荐使用 Docker Compose:克隆仓库后复制 .env.example 为 .env,填写 OPENAI_API_KEY 等必填配置,运行 docker compose up -d。默认访问 http://127.0.0.1:8000。也可本地开发:安装 Python 3.10+ 和 Node.js,运行 ./start.sh。

如何配置 AI 模型?

在 .env 文件中设置三个必填项:OPENAI_API_KEY(模型 API Key)、OPENAI_BASE_URL(兼容 OpenAI 格式的接口地址)、OPENAI_MODEL_NAME(需支持图片输入的模型名称)。可选配置 AI_DEBUG_MODE 开启调试日志。

如何导入闲鱼账号?

安装 Chrome 扩展“闲鱼登录态提取器”,在闲鱼页面登录后导出登录态 JSON 文件;然后在 Web UI 的账号管理页面粘贴 JSON 内容导入。登录态会保存到 state/ 目录,如 state/acc_1.json。

支持哪些通知渠道?

系统支持多种即时通知方式:ntfy.sh、企业微信、Bark、Telegram 和通用 Webhook。可在 Web UI 的系统设置中配置对应渠道的 Token 或 URL,任务触发时会自动推送匹配商品信息。

数据存储在哪里?如何备份?

主数据库为 SQLite,默认路径 data/app.sqlite3,存储任务、结果和价格历史;其他数据如登录态(state/)、日志(logs/)、图片(images/)为文件存储。备份时需保留 data/、state/、prompts/、logs/、images/ 等目录。Docker 部署时可通过卷挂载持久化这些目录。