whatisgithub

What is ai-goofish-monitor?

usagi-org/ai-goofish-monitor — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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.

What is it built with?

PythonPlaywrightDockerSQLite

How does it compare?

usagi-org/ai-goofish-monitorludwig-ai/ludwigflagopen/flagembedding
Stars11,69511,69611,674
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/54/53/5
Audiencegeneraldatadeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is ai-goofish-monitor?

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.

What language is ai-goofish-monitor written in?

Mainly Python. The stack also includes Python, Playwright, Docker.

What license does ai-goofish-monitor use?

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.

How hard is ai-goofish-monitor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ai-goofish-monitor for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.