ai-goofish-monitor

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

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

开源 free 办公效率

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 14437

维护状态低维护

是否开源是

定价模式 free

项目数据

分类办公效率

开发团队Usagi-org

所属国家

官网地址

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

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言Python

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

GitHub 星标★ 14437

30天Star增速

HF 下载量

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

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 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 相关变量前，任务无法正常进行分析。

核心亮点

基于 Playwright 自动化，稳定模拟真实用户行为，降低封号风险
AI 智能分析商品描述和价格，辅助决策，不只是简单关键词匹配
多任务实时/定时监控，后台 UI 完善，操作直观易用

不足之处

依赖闲鱼网页结构，平台改版可能导致脚本失效，需要持续维护
文档/社区待观察

适用场景

个人买家监控特定商品，降价或上新时及时提醒
二手商家分析竞品价格和热销趋势，辅助定价
研究闲鱼市场行情，批量收集商品数据进行统计分析

替代项目

XianyuMonitor、闲鱼助手、OpenXianyu

项目介绍

ai-goofish-monitor 是自动化工作流领域的开源项目，由 Usagi-org 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（14,437）位列前 4%，在自动化工作流分类的 511 个项目里位列前 8%。

近 41 天，它的 GitHub 星标从 14,129 增加到 14,437，净增 308。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：个人买家监控特定商品，降价或上新时及时提醒。同类可对比的替代方案包括 XianyuMonitor、闲鱼助手、OpenXianyu。

上一篇：web-dev-skills

下一篇：blurr