ai-goofish-monitor 闲鱼商品监控完整指南：5 分钟部署到 AI 自动捡漏

ai-goofish-monitor 闲鱼商品监控完整指南：5 分钟部署到 AI 自动捡漏

【免费下载链接】ai-goofish-monitor基于 Playwright 和AI实现的闲鱼多任务实时/定时监控与智能分析系统，配备了功能完善的后台管理UI。帮助用户从闲鱼海量商品中，找到心仪产品。项目地址: https://gitcode.com/GitHub_Trending/ai/ai-goofish-monitor

好价商品在闲鱼上架快、卖得快，人工刷列表根本盯不过来。ai-goofish-monitor 就是一个基于 Playwright + AI 的闲鱼商品监控系统，能多任务实时监控、自动筛选并推送结果，帮你把"蹲货"这件事交给它。技术上，后端是 FastAPI，前端用 Vue 3 + TypeScript，界面靠 WebSocket 实时推送状态，数据存在 SQLite，旧的 json/jsonl 格式也能自动迁移。下面按你的使用顺序走一遍。

面板跑起来之前，先让它落地。一条 clone、一个 .env、一条 compose 命令，监控面板就能打开。

5 分钟部署闲鱼监控系统

先克隆仓库，进到目录里：

git clone https://gitcode.com/GitHub_Trending/ai/ai-goofish-monitor cd ai-goofish-monitor cp .env.example .env

打开.env改这几处。AI 三项必填，其余按需调：

OPENAI_API_KEY=你的APIKey OPENAI_BASE_URL=模型兼容接口地址 OPENAI_MODEL_NAME=支持图片输入的模型名 WEB_USERNAME=admin WEB_PASSWORD=改成强密码 SERVER_PORT=8000 RUN_HEADLESS=true

• OPENAI_MODEL_NAME必须能读图，否则分析不出商品详情。
• 改了SERVER_PORT记得同步docker-compose.yaml的端口映射。
• Docker 里保持RUN_HEADLESS=true。

然后一条命令启动：

docker compose up -d

浏览器打开http://127.0.0.1:8000登录，监控概览面板就出来了。镜像已内置 Chromium，不用在宿主机装浏览器。首次启动会自动建 SQLite 库，并从旧的config.json、jsonl/、price_history/导入历史数据。

⚠️注意：默认 Web 账号是admin/admin123，上线前务必改掉。

面板只是开始。要让它真正"看见"商品，还得配登录态、建任务。

配好闲鱼登录态，建第一个监控任务

登录态决定它能不能抓数据，任务模式决定它怎么帮你筛——这两件事配完，闲鱼捡漏监控才算真正跑起来。

登录态从 Chrome 扩展导出。装好"闲鱼登录态提取"扩展，它会导出一段 JSON，你把这段 JSON 粘贴进 Web 的"闲鱼账号管理"页并保存。文件会落到state/目录，比如state/acc_1.json。多账号可以逐个导入，系统支持轮换使用；任务既能绑定某个账号，也能交给系统自动挑。

然后建任务。进"任务管理"点新建，两种模式按需选：

• AI 智能分析：用自然语言描述需求，比如"九成新、配件齐全、卖家信用好"。AI 会先帮你生成一份筛选标准，再据此用 AI 自动筛选闲鱼商品。适合你说不清规则、只想要"感觉对"的货。提交后弹独立进度窗口，后台异步生成。
• 关键词筛选：直接填关键词 + 价格区间 + 条件，任务立即创建，不走 AI 流程。适合规则明确、要快、想省 token 的场景。

常用筛选条件速览：

• 价格区间：min_price/max_price过滤。
• 区域筛选：省/市/区三级，基于闲鱼页面快照。它会把结果收得很小，建议先留空验证大盘。
• 发布时间：只盯新发布，比如"14天内"。
• 包邮：只看包邮商品。
• 账号绑定：指定用哪个登录态，或留空自动选。

💡提示：AI 模式先生成标准再建任务，所以不会即时完成，耐心看进度窗口即可。

任务跑起来后，真正拉开差距的是这四件事：换代理、定时跑、自动推、换模型。

进阶配置：代理轮换、Cron 定时与通知推送

任务稳定跑起来只是及格，下面这几项让它更稳、更快、更省心。

代理轮换与风控兜底。请求多了容易触发风控。系统内置失败检测，判定异常后自动切换账号或代理、冷却后重试，失效代理会进黑名单。相关开关在.env：

PROXY_ROTATION_ENABLED=true PROXY_ROTATION_MODE=round_robin PROXY_POOL=http://代理1:8080,http://代理2:8080 PROXY_ROTATION_RETRY_LIMIT=3

配套还有TASK_FAILURE_THRESHOLD、TASK_FAILURE_PAUSE_SECONDS控制失败阈值与暂停时长，PROXY_BLACKLIST_TTL控制黑名单有效期。

Cron 定时调度。给任务配一个 Cron 表达式，它就能按周期自动跑，不用手动触发。

通知推送。命中结果后会推到 ntfy.sh、企业微信、Bark、Telegram、Webhook 等渠道。配好对应变量即可，比如BARK_URL、NTFY_TOPIC_URL、TELEGRAM_BOT_TOKEN。

AI 模型切换。想换更强或更便宜的模型，改OPENAI_MODEL_NAME和OPENAI_BASE_URL就行，接口是 OpenAI 兼容的。

能力配够了，接下来是把边界划清楚——这是这套工具能用得久的关键。

安全与合规红线：登录态、频率与使用边界

用得久不难，关键是把三条边界守住：登录态当密钥、请求别太猛、用途只限学习研究。

• 登录态保管：state/里的文件含敏感 Cookie，等同密码。别提交到公开仓库，别分享给别人，容器里用state/挂载即可。
• 频率克制：合理设监控间隔和 Cron 频率，别对闲鱼服务器发太猛，遵守平台规则与 robots 约定，避免账号被限制。
• 使用边界：本项目仅供个人学习与技术研究，别用于商业竞争或非法用途，结果数据别二次扩散。
• Web 安全：改掉默认密码，能上 HTTPS 就上。

💡提示：登录态会随时间过期，建议定期用扩展重新导出一份覆盖。

想自己改点东西？代码按功能分好目录，改哪块直接进对应文件夹。

源码目录导读：想改哪块看哪个目录

• 路由接口：src/api/ 放所有 REST 与 WebSocket 路由，改 API 行为从这入手。
• 业务逻辑：src/services/ 是任务、AI 分析、通知、调度的核心，改"它怎么干活"看这里。
• 领域模型：src/domain/ 定义任务、结果、价格历史等实体与仓储，改数据结构看这。
• 基础设施：src/infrastructure/ 管持久化（SQLite/JSON）、外部 AI 与通知客户端、配置，换存储或加通知渠道看这里。

下一步建议：先把部署跑通，建一个关键词任务验证抓取，再慢慢上 AI 模式和代理轮换。项目采用 MIT 许可，放心二次开发。

【免费下载链接】ai-goofish-monitor基于 Playwright 和AI实现的闲鱼多任务实时/定时监控与智能分析系统，配备了功能完善的后台管理UI。帮助用户从闲鱼海量商品中，找到心仪产品。项目地址: https://gitcode.com/GitHub_Trending/ai/ai-goofish-monitor