This project provides a comprehensive, multi-user, multi-account system for automating responses and managing operations on Xianyu (a Chinese second-hand marketplace). It targets power users and sellers looking to streamline customer interactions, automate sales processes, and manage inventory efficiently, offering enterprise-grade features for enhanced productivity.

How It Works

The system employs a modular architecture featuring a FastAPI backend for its web interface and API, coupled with WebSocket connections for real-time message handling via XianyuAutoAsync.py. It utilizes SQLite for data persistence, ensuring user data isolation. Core functionalities like intelligent reply (keyword matching, OpenAI integration) and automated delivery/confirmation are managed by dedicated modules, with Playwright used for scraping real-time product data.

Quick Start & Requirements

Installation is streamlined via pre-built Docker images, requiring Docker 20.10+ and Docker Compose 2.0+. A single docker run command or docker-compose up -d can deploy the system. Alternatively, source builds require Python 3.11+, Node.js 16+, and Playwright browser installations (playwright install chromium). The system recommends 2GB+ RAM and 10GB+ storage. Access is via http://localhost:8080 with default credentials admin/admin123.

Highlighted Details

• Multi-User & Multi-Account: Supports independent user accounts with data isolation and management of unlimited Xianyu accounts per user.
• AI-Powered Responses: Integrates OpenAI API for intelligent, context-aware replies, complementing keyword-based automation with priority strategies.
• Automated Sales Workflow: Features auto-delivery (text, card data, images) and auto-confirmation of shipments, with configurable rules, multi-spec support, and anti-duplicate mechanisms.
• Real-time Data Scraping: Leverages Playwright to fetch live Xianyu product data, including details and multi-spec support, sorted by user interest ("people want").
• One-Click Deployment: Offers pre-built Docker images and deployment scripts for rapid setup on Windows, Linux, and macOS.

Maintenance & Community

The project is maintained by zhinianboke. Specific community links (Discord, Slack) are not detailed in the provided README, but contribution guidelines and contact methods via GitHub Issues and project groups are outlined.

Licensing & Compatibility

The project is explicitly licensed for learning and research purposes only ("仅供学习研究使用"). Commercial use, sales, profit generation, and illegal activities are strictly prohibited. Modifications require retaining original author information and copyright notices. Compatibility for commercial use is explicitly denied.

Limitations & Caveats

The primary limitation is the strict prohibition of commercial use, rendering it unsuitable for business operations or profit-driven applications. Users must ensure compliance with local laws and regulations. The project is intended solely for educational and research purposes.