1. 项目定位与用途
ai-goofish-monitor 是一个基于 Playwright 与 AI 的闲鱼商品智能监控系统,提供完整的 Web 管理界面。其核心定位是帮助买家从闲鱼海量商品中高效筛选出符合特定需求的目标。系统支持多任务并发监控,每个任务可独立配置关键词、价格、区域和 AI 分析标准;通过自然语言描述需求,AI 可自动生成分析规则,实现智能化商品筛选。同时,系统提供任务调度、即时通知、多账号代理轮换等功能,适用于个人或小团队进行闲鱼商品监控。
ai-goofish-monitor 是一个基于 Playwright 和 AI 的闲鱼商品智能监控工具,支持多任务并发、AI 深度分析、区域筛选和即时通知。适用于买家高效寻找心仪商品,提供 Docker 一键部署和完整的 Web 管理界面。本页面包含项目介绍、安装步骤、配置方法和使用教程。
ai-goofish-monitor 是一个基于 Playwright 与 AI 的闲鱼商品智能监控系统,支持多任务并发、AI 深度分析与 Web 可视化管理,帮助买家高效从海量闲鱼商品中筛选出心仪目标。
ai-goofish-monitor 是一个基于 Playwright 与 AI 的闲鱼商品智能监控系统,提供完整的 Web 管理界面。其核心定位是帮助买家从闲鱼海量商品中高效筛选出符合特定需求的目标。系统支持多任务并发监控,每个任务可独立配置关键词、价格、区域和 AI 分析标准;通过自然语言描述需求,AI 可自动生成分析规则,实现智能化商品筛选。同时,系统提供任务调度、即时通知、多账号代理轮换等功能,适用于个人或小团队进行闲鱼商品监控。
闲鱼平台商品数量庞大且更新频繁,手动浏览筛选效率极低,且难以持续跟踪新上架商品。本项目通过自动化爬虫实时监控商品列表,结合 AI 多模态分析(文本与图片)评估商品质量与匹配度,解决人工筛选的耗时与主观性问题。此外,系统通过多账号轮换、代理池和失败重试机制应对闲鱼风控,确保监控稳定性;通过多渠道即时通知(如 ntfy、企业微信等)让用户第一时间获取心仪商品信息。
主要适用于需要从闲鱼寻找特定商品的买家:1) 设置关键词监控,获取新发布商品通知;2) 使用 AI 分析商品图片和描述,判断真伪或质量(如二手电子产品、奢侈品);3) 定时周期性抓取特定区域或价格区间的商品;4) 管理多个闲鱼账号,分配不同监控任务并轮换代理以避免封禁;5) 通过 Web 界面集中管理所有任务、查看历史结果和运行日志,实现系统化寻物。
推荐使用 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 或手动启动前后端。
首次使用需登录 Web UI(默认 admin/admin123),在账号管理页面通过 Chrome 扩展导出闲鱼登录态 JSON 并导入,登录态保存至 state/ 目录。然后在任务管理页面创建任务:选择 AI 模式(填写详细需求,后台生成分析标准)或关键词模式(直接填写规则),配置价格、区域、定时等参数并绑定账号。任务运行后,在结果页面查看匹配商品,系统会根据配置推送通知至 ntfy、企业微信等渠道。日志页面可监控任务运行状态和排查问题。
数据存储方面,主数据库为 SQLite(默认 data/app.sqlite3),存储任务、结果和价格历史;文件系统目录如 state/(登录态)、logs/(日志)、images/(商品图片)独立存储。应用启动时会自动建库并尝试从旧 config.json 等导入历史数据。配置通过 .env 文件管理,支持代理设置、AI 调试模式等。开发环境下,前端基于 Vue 3 + Vite,后端为 FastAPI,测试使用 pytest。系统支持 Cron 表达式定时任务,区域筛选数据基于闲鱼页面快照内置。注意:Docker 部署时必须设置 RUN_HEADLESS=true。
推荐使用 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。
在 .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 部署时可通过卷挂载持久化这些目录。