ai-goofish-monitor

闲鱼多任务监控+AI分析，自动帮你找到心仪好物

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署办公效率 🍴 复刻 3048 🐛 待处理 50 👀 关注 72

GitHub ↗

GitHub 星标 ★ 18491

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

ai-goofish-monitor 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类办公效率

开发团队Usagi-org

GitHubhttps://github.com/Usagi-org/ai-goofish-monitor

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,ai-assistant,ai-tools,automation,gemini,goofish,open-source,openai,playwright,tool,xian-yu,xianyu,xianyu-bot

GitHub 星标★ 18491

上线时间2025-07-16 00:00:00

代码更新2026-10-10

仓库体积9.4 MB

本站数据更新2026-11-09

维护状态维护中

收录时间2026-08-09

浏览次数5

项目介绍

ai-goofish-monitor 是一个基于 Playwright 和 AI 的闲鱼多任务实时监控与智能分析系统，配备功能完善的后台管理 UI。它通过自动化浏览器技术模拟用户操作，实现对闲鱼商品的多任务实时或定时监控，并利用 AI 模型对抓取的商品数据进行智能分析，帮助用户从海量商品中高效筛选出心仪产品。系统支持多任务并发管理，用户可自定义监控规则和定时任务，后台界面提供直观的数据展示和操作控制。该项目主要解决闲鱼平台商品信息分散、手动搜索效率低的问题，将监控、分析、通知等流程自动化，适用于个人购物决策、二手交易研究、价格趋势跟踪等场景。核心能力包括多任务调度、AI 语义分析、可视化后台管理，以及灵活的配置选项。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 18491

技术标签

ai ai-assistant ai-tools automation gemini

使用教程

难度：入门约 15 分钟部署方式：Docker 7 步

环境要求

已安装 Docker 与 Docker Compose
可访问 GitHub 与容器镜像仓库（ghcr.io）
准备 OpenAI 兼容的 AI 模型 API Key 与接口地址
准备一个支持图片输入的模型名称
宿主机 8000 端口可用

安装与启动步骤

1克隆项目仓库

从 GitHub 拉取源码并进入项目目录，后续所有命令都在该目录执行。
```
git clone https://github.com/Usagi-org/ai-goofish-monitor && cd ai-goofish-monitor
```
2复制并填写配置

从示例文件生成 .env，填入 AI Key、接口地址、模型名等必填项后再启动。
```
cp .env.example .env
vim .env
```
3启动容器服务

docker compose 会拉取官方镜像并后台启动 app 服务，首次拉取耗时较长。
```
docker compose up -d
```
4查看运行日志

持续输出容器日志，确认服务无报错、初始化完成；按 Ctrl+C 退出查看不影响运行。
```
docker compose logs -f app
```
5访问并登录后台

浏览器打开默认地址 http://127.0.0.1:8000，用 WEB_USERNAME / WEB_PASSWORD 登录。
6导入闲鱼登录态

进入“闲鱼账号管理”，用 Chrome 扩展导出闲鱼登录态 JSON 并粘贴，文件会存到 state/ 目录。
7创建并运行任务

回到“任务管理”新建监控任务，绑定已导入的账号后即可开始监控。

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	AI 模型 API Key，接入大模型分析商品必填	`sk-xxxxxxxxxxxxxxxx`
`OPENAI_BASE_URL`	是	OpenAI 兼容接口地址	`https://api.openai.com/v1`
`OPENAI_MODEL_NAME`	是	模型名称，需支持图片输入	`gpt-4o`
`WEB_USERNAME`	否	Web UI 登录用户名，默认 admin	`admin`
`WEB_PASSWORD`	否	Web UI 登录密码，默认 admin123	`admin123`
`SERVER_PORT`	否	后端监听端口，默认 8000，改动需同步端口映射	`8000`

如何确认成功

执行 docker compose logs -f app 无报错，浏览器打开 http://127.0.0.1:8000 能正常登录即成功。

常见问题

Q：镜像下载很慢或拉不下来怎么办？

A：可改用镜像加速：docker pull ghcr.nju.edu.cn/usagi-org/ai-goofish:latest，再 docker tag 为 ghcr.io/usagi-org/ai-goofish:latest，最后 docker compose up -d。

Q：Docker 里还需要自己装浏览器吗？

A：不需要。Docker 镜像已内置 Chromium，宿主机无需额外安装浏览器。

Q：改了 SERVER_PORT 后访问不了？

A：需要同步修改 docker-compose.yaml 里的端口映射，容器端口与宿主机映射保持一致才能访问。

Q：数据保存在哪里？

A：主存储为 SQLite，默认路径 data/app.sqlite3，可通过环境变量 APP_DATABASE_FILE 自定义路径。

Q：如何更新到最新版本？

A：在项目目录执行 docker compose pull && docker compose up -d 即可拉取新镜像并重启。

注意事项

docker-compose.yaml 默认把 SQLite 主库挂载到 ./data:/app/data，请勿随意删除 data/ 等持久化目录。
默认持久化目录包括 data/、state/、logs/、images/、prompts/ 以及 config.json、jsonl/、price_history/。
Docker 中 RUN_HEADLESS 应保持 true；镜像未内置 Edge，容器内固定使用 Chromium。
未配置好 .env 中的 AI 相关变量前，任务无法正常进行分析。