闲鱼智能监控机器人
扫码查看

一个自动监控并分析闲鱼商品的AI工具

闲鱼智能监控机器人

综合介绍

闲鱼智能监控机器人是一个结合了 Playwright 自动化技术和 AI 分析能力的开源工具,专门用于实时监控闲鱼平台上的商品信息。 它提供了一个功能齐全的Web管理界面,用户不需要直接操作复杂的代码和配置文件,就可以轻松管理监控任务。 这个工具最大的特点是引入了AI技术,用户只需要用日常语言描述自己的购买需求,系统就能自动创建一个带有详细筛选条件的监控任务。 工具能够同时执行多个独立的监控任务,实时发现新发布的商品,并立刻调用大语言模型(例如GPT-4o)对商品的图片、文字描述以及卖家信息进行综合分析,从而判断该商品是否值得购买。 对于符合条件的商品,系统会通过即时通讯服务把通知推送到用户的手机或电脑上,帮助用户抓住交易机会。

功能列表

  • 可视化Web界面: 提供完整的Web UI,支持任务的可视化管理、AI标准在线编辑、运行日志实时查看和结果筛选浏览,无需直接操作命令行和配置文件。
  • AI驱动的任务创建: 只需用自然语言描述购买需求,即可一键创建包含复杂筛选逻辑的全新监控任务。
  • 多任务并发: 支持通过配置文件同时监控多个关键词,各个任务独立运行,互不干扰。
  • 实时流式处理: 发现新商品后,立即进入分析流程,告别批处理延迟,处理速度快。
  • 深度AI分析: 集成多模态大语言模型(如GPT-4o),结合商品图文和卖家画像进行深度分析,筛选更精准。
  • 高度可定制: 每个监控任务都可以独立配置关键词、价格范围、筛选条件和AI分析指令(Prompt)。
  • 即时通知: 支持通过ntfy.sh和企业微信机器人将符合AI推荐的商品立即推送到用户的手机或桌面。
  • 反爬虫策略: 通过模拟真实的网页用户操作,包含多种随机延迟和行为,提高了运行的稳定性,降低了被平台检测到的风险。

使用帮助

本项目推荐使用Web管理界面进行操作,这可以带来最佳的使用体验。

第一步: 环境准备

首先,你需要将项目文件下载到你的电脑里,并安装运行它所必需的软件库。

  1. 克隆项目打开终端(在Windows上是命令提示符或PowerShell,在macOS或Linux上是Terminal),输入以下命令并回车,将项目代码从GitHub克隆到本地:
    git clone https://github.com/dingyufei615/ai-goofish-monitor
    

    然后进入项目目录:

    cd ai-goofish-monitor
    
  2. 安装依赖项目依赖一些Python库来运行,通过以下命令进行安装:
    pip install -r requirements.txt
    

第二步: 基础配置

在正式运行前,需要对一些关键信息进行配置,例如你的AI模型访问密钥和通知服务的地址。

  1. 配置环境变量在项目的根目录中,手动创建一个名为.env的文件。然后用文本编辑器打开它,填入以下内容。请务必将引号内的示例值替换为你自己的信息。
    # OpenAI API 相关配置
    # 你的OpenAI API密钥
    OPENAI_API_KEY="sk-..." 
    # 你的OpenAI API基础URL,如果使用代理,请修改为代理地址
    OPENAI_BASE_URL="https://api.openai.com/v1" 
    # 使用的模型名称,例如gpt-4o
    OPENAI_MODEL_NAME="gpt-4o" 
    # ntfy 通知服务配置
    # 替换为你的ntfy主题URL,用于接收通知
    NTFY_TOPIC_URL="https://ntfy.sh/your-topic-name" 
    # 企业微信机器人通知配置(可选)
    WX_BOT_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxx" 
    # 浏览器登录配置,默认使用Chrome,设为true则使用Edge
    LOGIN_IS_EDGE=false 
    # 是否将商品电脑版链接转换为手机版链接,方便在手机上打开
    PCURL_TO_MOBILE=true 
    # 是否以无头模式运行爬虫。如果频繁遇到滑动验证码,可以设为false,手动进行验证
    RUN_HEADLESS=true
    
  2. 获取闲鱼登录状态 (重要)为了让程序能够正常访问闲鱼数据,必须先获取并保存你的登录信息。在终端中运行登录脚本:
    python login.py
    

    程序会自动打开一个浏览器窗口,并显示一个二维码。请使用你的手机闲鱼App扫描该二维码完成登录。 登录成功后,浏览器窗口会自动关闭,同时在项目根目录下生成一个名为xianyu_state.json的文件,这个文件保存了你的登录状态。

第三步: 启动Web服务

完成以上所有配置后,就可以启动项目的Web管理后台了。在终端中运行以下命令:

python web_server.py

第四步: 开始使用

现在,你可以通过浏览器来操作这个监控工具了。

  1. 打开浏览器(推荐使用Chrome或Edge),访问 http://127.0.0.1:8000,你将看到Web管理界面。
  2. 在“任务管理”页面,点击“创建新任务”按钮。
  3. 在弹出的窗口中,用自然语言描述你的购买需求。例如,你可以输入:“我想买一台95新以上的索尼A7M4相机,预算1万3以内,快门数低于5000”。同时,为这个任务起一个名字,并填写核心搜索关键词(如“A7M4”)。
  4. 点击创建后,AI会根据你的描述,自动为你生成一套详细的分析标准(Prompt)。
  5. 回到主界面,点击页面右上角的“🚀 全部启动”按钮,监控任务就会开始自动运行。

Web界面功能导览

  • 任务管理
    • AI创建任务: 用日常语言描述需求,一键生成监控任务及配套的AI分析标准。
    • 可视化编辑: 在表格中直接修改任务的参数,如关键词、价格区间等。
    • 启停控制: 可以单独启动或停止某个任务,也可以一键控制所有任务的运行状态。
  • 结果查看
    • 卡片式浏览: 以图文并茂的卡片形式展示所有抓取到的商品,非常直观。
    • 智能筛选: 可以一键筛选出所有被AI标记为“推荐”的商品,快速找到目标。
    • 深度详情: 点击卡片可以查看商品的完整抓取数据和AI给出的详细分析报告。
  • 运行日志
    • 实时日志流: 在网页上可以实时看到程序运行的详细日志,方便你了解当前进度或排查可能出现的问题。
  • 系统设置
    • 状态检查: 一键检查.env配置文件、xianyu_state.json登录文件等关键依赖是否都已准备就绪。
    • Prompt在线编辑: 你可以直接在网页上修改用于AI分析的指令(Prompt),并保存。这样可以实时调整AI的筛选逻辑,让它更符合你的要求。

应用场景

  1. 监控稀缺或热门商品对于一些限量版、停产的电子产品或热门商品(如显卡、特定型号的相机镜头),这些商品在二手市场上一出现就可能被很快买走。用户可以设置一个针对这些商品的监控任务,一旦有符合条件的商品上架,系统会立即分析并推送通知,大大增加了购买成功率。
  2. 寻找低于市场价的“捡漏”商品用户可以设定一个低于正常市场价的价格区间,并结合AI分析来过滤掉描述不清、图片模糊或卖家信用度低的商品。这样,当有卖家因急于出售而标价过低时,用户可以第一时间发现,实现“捡漏”。
  3. 长期追踪特定品类对于收藏家(如模型、邮票、老旧书籍)或需要长期购买某一类二手商品的用户,可以建立一个常驻的监控任务。AI可以帮助从海量商品中筛选出精品,过滤掉大量不相关的或品质差的商品,节省用户手动浏览和筛选的时间。
  4. 跨地区比价某些商品在不同地区的价格可能存在差异。用户可以设定多个任务,分别监控不同地区的商品,通过AI对商品成色、配件、卖家信用等维度的综合分析,找到性价比最高的购买选项。

QA

  1. 这个工具是免费的吗?该项目本身是开源免费的。 但是,它依赖OpenAI的AI服务来进行智能分析,因此你需要拥有一个OpenAI API密钥,并承担使用其模型(如GPT-4o)所产生的费用。
  2. 我的闲鱼账号会因为使用这个工具而被封禁吗?任何自动化工具都存在一定的风险。该项目通过模拟真人的操作习惯(如随机延迟)来降低被检测到的风险,但无法完全保证100%安全。 建议不要设置过于频繁的请求,以免对闲鱼服务器造成负担或导致账号被限制。
  3. 我需要一直开着电脑才能让它运行吗?是的。由于这是一个在本地运行的程序,你需要让你的电脑保持开机和联网状态,并持续运行web_server.py脚本,才能保证监控不间断。如果需要长期运行,可以考虑将其部署在服务器上。
  4. 如果遇到了滑动验证码导致程序卡住怎么办?你可以在.env配置文件中,将RUN_HEADLESS的值从true修改为false。 这样,当程序需要登录或遇到验证时,会弹出一个真实的浏览器窗口,你可以手动完成滑动验证,之后程序即可继续自动运行。
微信微博Email复制链接