xianyu-monitor

Monitor Xianyu search results and detect newly posted listings for specified keywords.

40|5|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/voltwake/xianyu-monitor --skill xianyu-monitor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xianyu-monitor
Source: https://github.com/voltwake/xianyu-monitor/tree/main
Command: npx skills add https://github.com/voltwake/xianyu-monitor --skill xianyu-monitor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires puppeteer-core, better-sqlite3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Many users miss newly listed second-hand items on 闲鱼 (Goofish) because manual searches are slow, login/cookie restrictions and anti-bot measures prevent reliable automated scraping, and duplicate notifications drown out useful alerts. This Skill automates periodic searches, filters results by price/region/text, deduplicates discoveries, and produces structured outputs for real-time notifications so users can act fast on valuable listings.

Core Features & Use Cases

  • Keyword search & scheduling: define multiple monitored keywords and run scans on a cron schedule to catch new listings as they appear.
  • Rich filtering: price range, region filtering, exclude/include text rules, and time-window (--hours) constraints to focus alerts.
  • Anti-detection navigation: uses a non-headless Chrome instance, AppleScript address-bar navigation, and CDP input events to avoid Goofish anti-automation blocks.
  • Deduplication & history: local SQLite stores tasks and discovered items to prevent repeated notifications and provide a discovery history.
  • Integration-ready outputs: prints JSON between markers for easy parsing and forwarding to Discord or Telegram via an external notifier or OpenClaw cron job.

Quick Start

Start the Chrome instance, log into goofish.com in the opened browser, then add a monitoring task for a target (for example add a task for iPhone 16 with node scripts/xianyu.js add --keyword iPhone 16 --min-price 3000 --max-price 5000) and run node scripts/xianyu.js scan --hours 24 to test.

Frequently Asked Questions about xianyu-monitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Xianyu monitoring to catch newly posted second-hand items?

Xianyu monitoring automates periodic keyword searches and filters results by price, region, and text rules to catch new listings. It runs scheduled scans on a non-headless Chrome instance and stores discovered items in a local SQLite database to deduplicate alerts.

How do I scrape Goofish search results without triggering anti-bot blocks?

Scraping Goofish search results without triggering anti-bot blocks requires a non-headless Chrome instance with remote debugging enabled. The automation uses AppleScript address-bar navigation and CDP input events to bypass anti-automation measures during keyword searches and filtering.

Can I filter Xianyu search alerts by price range and region?

Yes, you can filter Xianyu search alerts by price range and region. The monitoring task setup supports minimum and maximum price constraints, region filtering, exclude/include text rules, and time-window constraints to ensure you only receive notifications for relevant listings.

Does automated Xianyu web scraping work on macOS?

Automated Xianyu web scraping works on macOS where a non-headless Chrome instance can be automated and controlled via AppleScript. This macOS-specific setup enables address-bar navigation required to bypass Goofish anti-automation checks during scheduled search scans.

How do I send Xianyu monitoring alerts to Discord or Telegram?

To send Xianyu monitoring alerts to Discord or Telegram, the script prints JSON outputs between markers for easy parsing. You can forward this structured data via an external notifier or schedule it using an OpenClaw cron job for real-time push alerts.

Why do I need better-sqlite3 and puppeteer-core for Xianyu monitoring?

You need puppeteer-core to automate the non-headless Chrome browser for Goofish searches, and better-sqlite3 to maintain a local SQLite database. This database handles deduplication of discovered items and task storage to prevent repeated notifications for listings already found.