explaingit

usagi-org/ai-goofish-monitor

11,695PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

An automated monitor for China's Xianyu second-hand marketplace that watches for listings matching your criteria around the clock and alerts you via Telegram or other services when something worth buying appears.

Mindmap

mindmap
  root((ai-goofish-monitor))
    What it does
      Xianyu monitoring
      AI listing filter
      24/7 alerts
    Filters
      Price range
      Shipping option
      City or district
      AI relevance score
    Alerts
      Telegram
      Bark
      WeChat Work
      Custom webhooks
    Infrastructure
      Docker
      Web interface
      SQLite storage
      Proxy rotation
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Monitor Xianyu for a specific item 24/7 and receive a Telegram notification the moment a matching listing appears.

USE CASE 2

Filter listings by price range and shipping availability before an AI scores them for personal relevance.

USE CASE 3

Run multiple concurrent monitoring tasks, each watching different item categories with its own alert settings.

USE CASE 4

Rotate multiple Xianyu login accounts to reduce the chance of any single account being flagged for excessive activity.

Tech stack

PythonPlaywrightDockerSQLite

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Xianyu account login session and optionally a Telegram bot token or other notification service credentials.

MIT, free to use for any purpose, though the authors state it is intended for personal learning and research rather than commercial scraping at scale.

In plain English

This project is an automated monitoring system for Xianyu (informally known as Idle Fish), China's largest second-hand marketplace run by Alibaba. Instead of manually refreshing the site to check for new listings, you set up tasks that watch for specific items around the clock and alert you the moment something matching your criteria appears. It is written in Python and uses a browser automation library called Playwright to navigate Xianyu the way a human would, without a formal API. You control everything through a web interface that runs on your own computer or server. From there you create monitoring tasks by describing what you want in plain language and letting the built-in AI figure out the details, or by typing keywords directly. Each task can target specific price ranges, filter by whether the seller ships or only meets locally, restrict results to a particular city or district, and apply its own AI prompt to judge whether a listing is actually worth buying. Multiple tasks can run at the same time, each with its own settings and its own bound account. When a listing passes all your filters and the AI rates it as worth your attention, the tool sends you a notification. You can receive alerts through several services including Telegram, Bark, WeChat Work, ntfy.sh, or a custom webhook. The notification carries the item details the tool gathered from the listing page. For reliability, the system lets you manage multiple Xianyu login sessions and rotate between them so that no single account gets flagged for excessive activity. It also supports a proxy pool with automatic rotation and retry on failure. All results, price history, and logs are stored in a local SQLite database. Running it is straightforward via Docker: a single command pulls the image and starts the server with a built-in Chromium browser, so you do not need to install a separate browser on the host. A web interface is then available at port 8000. The project is released under the MIT license and is described by its authors as intended for personal learning and research rather than commercial scraping at scale.

Copy-paste prompts

Prompt 1
I want to watch Xianyu for iPhone 14 listings under 2000 yuan. How do I create a monitoring task in ai-goofish-monitor?
Prompt 2
How do I connect ai-goofish-monitor to Telegram so I get a message whenever a matching listing is found?
Prompt 3
I want to run ai-goofish-monitor using Docker. What is the one-command setup and how do I access the web interface?
Prompt 4
How do I add multiple Xianyu accounts to ai-goofish-monitor so the system rotates between them?
Open on GitHub → Explain another repo

← usagi-org on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.