Usagi-org / ai-goofish-monitor

查看原文 / View Original 编辑 / Edit

Usagi-org / ai-goofish-monitor

闲鱼智能监控系统 [中文] ｜ English 基于 Playwright 和 AI 的闲鱼多任务实时监控，提供完整的 Web 管理界面。

The Xianyu (Goofish) Intelligent Monitoring System is a multi-task, real-time monitoring tool for Xianyu based on Playwright and AI, featuring a complete Web management interface.

核心特性 (Core Features)

  • Web 可视化管理: 任务管理、账号管理、AI 标准编辑、运行日志、结果浏览

  • AI 驱动: 自然语言创建任务，多模态模型深度分析商品

  • 多任务并发: 独立配置关键词、价格、筛选条件和 AI Prompt

  • 高级筛选: 包邮、新发布时间范围、省/市/区三级区域筛选

  • 即时通知: 支持 ntfy.sh、企业微信、Bark、Telegram、Webhook 等多渠道

  • 定时调度: 支持 Cron 配置周期性任务

  • 账号与代理轮换: 多账号管理、任务绑定账号、代理池轮换与失败重试

  • Docker 部署: 一键容器化部署

  • Web Visual Management: Task management, account management, AI criteria editing, operation logs, and result browsing.

  • AI-Driven: Create tasks using natural language; deep analysis of products via multimodal models.

  • Multi-task Concurrency: Independent configuration for keywords, prices, filters, and AI prompts.

  • Advanced Filtering: Free shipping, new release time ranges, and three-tier (province/city/district) regional filtering.

  • Instant Notifications: Supports ntfy.sh, WeChat Work, Bark, Telegram, Webhooks, and more.

  • Scheduled Tasks: Supports Cron for periodic task configuration.

  • Account & Proxy Rotation: Multi-account management, task-to-account binding, proxy pool rotation, and failure retries.

  • Docker Deployment: One-click containerized deployment.

🐳 Docker 部署（推荐） (Docker Deployment - Recommended)

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

If the image is inaccessible or download speeds are slow, you can try using a mirror:

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，无需宿主机额外安装浏览器。

The default Web UI address is http://127.0.0.1:8000. The Docker image includes Chromium, so no additional browser installation is required on the host machine.

数据存储与迁移 (Data Storage and Migration)

当前在线主存储为 SQLite，默认路径 data/app.sqlite3。可通过环境变量 APP_DATABASE_FILE 自定义数据库路径；Docker 默认设置为 /app/data/app.sqlite3。应用启动时会自动建库建表，并尝试从旧的 config.json、jsonl/、price_history/ 导入一次历史数据。

The current primary online storage is SQLite, with the default path at data/app.sqlite3. You can customize the database path via the APP_DATABASE_FILE environment variable; the Docker default is set to /app/data/app.sqlite3. Upon startup, the application automatically creates the database and tables, and attempts to import historical data from legacy config.json, jsonl/, and price_history/ files once.

🚀 工作流程 (Workflow)

下图描述了单个监控任务从启动到完成的核心处理逻辑。主服务运行于 src.app，按用户操作或定时调度启动一个或多个任务进程。

The diagram below describes the core processing logic of a single monitoring task from start to finish. The main service runs on src.app and initiates one or more task processes based on user actions or scheduled triggers.

注意事项 (Important Notes)

请遵守闲鱼的用户协议和 robots.txt 规则，不要进行过于频繁的请求，以免对服务器造成负担或导致账号被限制。本项目仅供学习和技术研究使用，请勿用于非法用途。本项目采用 MIT 许可证发布，按”现状”提供，不提供任何形式的担保。

Please comply with Xianyu’s user agreement and robots.txt rules. Do not make requests too frequently to avoid burdening the server or getting your account restricted. This project is for learning and technical research purposes only; do not use it for illegal activities. This project is released under the MIT License and is provided “as is” without any form of warranty.

← 返回新闻列表 / Back to news list