Usagi-org /ai-goofish-monitor

基于 Playwright 和AI实现的闲鱼多任务实时/定时监控与智能分析系统,配备了功能完善的后台管理UI。帮助用户从闲鱼海量商品中,找到心仪产品。

★ 20,001⑂ 3,236👁 73⑃ 199● 335▤ 10
PythonMITCreated 2025-07-16
下载:2.52.5 ↓2.52026-10-09
+79
日增长
20,001
stars
3,236
forks
73
watchers
199
prs
335
issues
10
releases

README

闲鱼智能监控系统

[中文] | English

基于 Playwright 和 AI 的闲鱼多任务实时监控,提供完整的 Web 管理界面。


 核心特性

- Web 可视化管理: 任务管理、账号管理、AI 标准编辑、运行日志、结果浏览
- AI 驱动: 自然语言创建任务,多模态模型深度分析商品
- 多任务并发: 独立配置关键词、价格、筛选条件和 AI Prompt
- 高级筛选: 包邮、新发布时间范围、省/市/区三级区域筛选
- 即时通知: 支持 ntfy.sh、企业微信、Bark、Telegram、Webhook等多渠道
- 定时调度: 支持 Cron 配置周期性任务
- 账号与代理轮换: 多账号管理、任务绑定账号、代理池轮换与失败重试
- Docker 部署: 一键容器化部署

 截图

!监控概览
!任务管理
!结果查看
!通知推送

 🐳 Docker 部署(推荐)

bash
git clone https://github.com/Usagi-org/ai-goofish-monitor && cd ai-goofish-monitor
cp .env.example .env
vim .env  填写相关配置项
docker compose up -d
docker compose logs -f app
docker compose down


如果镜像无法访问或下载速度慢,可尝试使用加速:
bash

docker pull ghcr.nju.edu.cn/usagi-org/ai-goofish:latest
docker tag ghcr.nju.edu.cn/usagi-org/ai-goofish:latest ghcr.io/usagi-org/ai-goofish:latest
docker compose up -d



- 默认 Web UI 地址:http://127.0.0.1:8000
- Docker 镜像已内置 Chromium,无需宿主机额外安装浏览器。
- 官方镜像地址:ghcr.io/usagi-org/ai-goofish:latest
- 更新镜像:docker compose pull && docker compose up -d
- 如果你修改了 .env 中的 SERVER_PORT,请同步更新 docker-compose.yaml 里的端口映射。
- docker-compose.yaml 默认会把 SQLite 主库挂载到 ./data:/app/data,数据库文件默认为 data/app.sqlite3
- 目前默认持久化这些目录:
    - data/  SQLite 主存储(任务、结果、价格历史)
    - state/  登录状态 cookie 文件
    - prompts/  任务提示词
    - logs/  运行日志
    - images/  商品图片与任务临时图片目录
    - config.json、jsonl/、price_history/  首次升级到 SQLite 时用于兼容导入的旧数据源

 数据存储与迁移

- 当前在线主存储为 SQLite,默认路径 data/app.sqlite3
- 可通过环境变量 APP_DATABASE_FILE 自定义数据库路径;Docker 默认设置为 /app/data/app.sqlite3
- 应用启动时会自动建库建表,并尝试从旧的 config.json、jsonl/、price_history/ 导入一次历史数据
- state/、prompts/、logs/、images/ 仍然是文件系统目录,不在 SQLite 中
- 商品图片会临时落到 images/task_images_/,任务结束后默认会清理
- 首次升级完成并确认 data/app.sqlite3 中数据正确后,可视部署方式决定是否继续保留旧的 config.json、jsonl/、price_history/ 挂载

 最少配置

| 变量 | 说明 | 必填 |
|------|------|------|
| OPENAI_API_KEY | AI 模型 API Key | 是 |
| OPENAI_BASE_URL | OpenAI 兼容接口地址 | 是 |
| OPENAI_MODEL_NAME | 支持图片输入的模型名称 | 是 |
| WEB_USERNAME / WEB_PASSWORD | Web UI 登录账号密码,默认 admin/admin123 | 否 |

其余配置见下方“配置说明”。


 第一次使用

1. 打开默认 Web UI http://127.0.0.1:8000 并登录。
2. 进入“闲鱼账号管理”,使用 Chrome 扩展 导出并粘贴闲鱼登录态 JSON。
3. 登录态文件会保存到 state/ 目录,例如 state/acc_1.json。
4. 回到“任务管理”,创建任务并绑定账号后即可运行。

 创建第一个任务

- AI判断:填写“详细需求”,提交后会弹出独立进度弹窗,后台异步生成分析标准。
- 关键词判断:填写关键词规则,任务会直接创建,不经过 AI 生成流程。
- 区域筛选:已改为省 / 市 / 区三级选择器,数据基于闲鱼页面抓取快照内置。



 用户使用说明


点击展开 Web UI 功能说明

 任务管理

- 支持 AI 创建、关键词规则、价格范围、新发布范围、区域筛选、账号绑定、定时规则。
- AI 任务创建是后台 job 流程,提交后会打开单独的进度弹窗。
- 区域筛选会显著缩小结果集,默认留空。

 账号管理

- 支持导入、更新、删除闲鱼账号登录态。
- 每个任务可指定账号,也可不绑定并交给系统自动选择。

 结果查看与运行日志

- 结果页和导出功能现在从 SQLite 查询,不再直接扫描 jsonl 文件。
- 日志页按任务展示运行过程,便于排查登录态失效、风控和 AI 调用问题。

 系统设置

- 可查看系统状态、编辑 Prompt、调整代理与轮换相关配置。





 开发者开发

 环境要求

- Python 3.10+
- Node.js + npm(本地验证 Node v20.18.3 可完成前端构建)
- Playwright CLI 与 Chromium,首次运行前建议执行 python3 -m pip install playwright && python3 -m playwright install chromium
- Chrome / Edge 浏览器(Linux 环境也可使用 Chromium;start.sh 会先检查浏览器是否存在)

bash
git clone https://github.com/Usagi-org/ai-goofish-monitor
cd ai-goofish-monitor
cp .env.example .env


 一键启动

bash
chmod +x start.sh
./start.sh


start.s

Top issues

Latest release

2.5 2.5 2026-10-09
What's Changed
 fix(ai-response-parser): 支持智谱 OpenAI 兼容网关的 reasoning_content 回退 by @QuasarNe in https://github.com/Usagi-org/ai-goofish-monitor/pull/450
 feat(results): add blacklist rules for result filtering by @dingyufei615 in https://github.com/Usagi-org/ai-goofish-monitor/pull/484
 feat(results): support regex blacklist aliases by @dingyufei615 in https://github.com/Usagi-org/ai-goofish-monitor/pull/486
 fix: path traversal vulnerability in /api/prompts/{filename} (Windows) by @AAtomical in https://github.com/Usagi-org/ai-goofish-monitor/pull/489
 fix: restore search, region filter, 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON