zhinianboke/xianyu-auto-reply

★ 4,532TypeScriptAudience · developerComplexity · 4/5Setup · hard

Mindmap

mindmap
  root((xianyu-auto-reply))
    What it does
      Auto-reply to buyers
      Order management
      Digital goods shipping
      Scheduled re-listing
    Tech Stack
      TypeScript
      Python FastAPI
      React
      MySQL Redis
    Deployment
      Docker Compose
      Windows EXE
      Local dev
    Store Features
      Multi-account
      Batch listing
      Affiliate tracking

mindmap root((xianyu-auto-reply)) What it does Auto-reply to buyers Order management Digital goods shipping Scheduled re-listing Tech Stack TypeScript Python FastAPI React MySQL Redis Deployment Docker Compose Windows EXE Local dev Store Features Multi-account Batch listing Affiliate tracking

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Automatically reply to buyer inquiries on Xianyu using AI or keyword rules so your store never goes silent overnight.

USE CASE 2

Manage multiple Xianyu seller accounts and product listings from a single React dashboard.

USE CASE 3

Automatically ship digital goods and confirm receipt on orders without manual steps.

USE CASE 4

Schedule items to be re-listed on a timer so they stay visible in Xianyu search results.

Tech stack

TypeScriptPythonFastAPIReactMySQLRedisDockerPlaywright

Getting it running

Difficulty · hard Time to first run · 1h+

Requires MySQL 8.0, Redis 7, and Python 3.11 on Linux or 3.12 on Windows, Docker Compose is recommended for production, documentation is in Chinese.

No license information was mentioned in the explanation.

In plain English

xianyu-auto-reply is an automated customer service and store management system built for Xianyu, a second-hand marketplace operated by Alibaba, similar to eBay or Facebook Marketplace but widely used in China. The system connects to Xianyu's messaging service via WebSocket, receives buyer inquiries in real time, and replies automatically using either keyword matching or an AI assistant backed by the OpenAI API. The project is structured as a microservice application with six components: a web backend built in Python and FastAPI, a WebSocket service that handles real-time messaging using Playwright for browser automation, a scheduler for timed tasks like re-listing items and rate-limit tracking, a MySQL database, a Redis cache, and a React-based frontend dashboard. These components can be deployed together via Docker Compose, run locally for development, or packaged as a standalone Windows EXE. Beyond automated replies, the system handles a broad range of store operations: fetching and managing orders, managing product listings, automatic shipment of digital goods (card codes), automatic confirmation of receipt, automatic buyer reviews, scheduled re-listing of items to keep them visible in search results, batch publishing of new listings, and automatic cookie refresh to maintain account login state. Multiple Xianyu seller accounts can be managed simultaneously. The admin dashboard includes user account management with multiple roles, a data statistics panel, a risk control log, and support for multi-level reseller structures. An optional promotions module handles affiliate link integration and commission tracking. Deployment requires Python 3.11 on Linux or Python 3.12 on Windows, along with MySQL 8.0 and Redis 7. Docker Compose is the recommended method for production. The project documentation is written in Chinese.

Copy-paste prompts

Prompt 1

Set up xianyu-auto-reply with Docker Compose on Linux, including MySQL 8.0 and Redis 7. Show me the docker-compose.yml and the required environment variables.

Prompt 2

I want to configure keyword-based auto-replies for my Xianyu store. How do I add custom keywords and responses in the xianyu-auto-reply admin dashboard?

Prompt 3

How do I connect xianyu-auto-reply to the OpenAI API so it can generate AI-powered customer service replies for Xianyu buyers?

Prompt 4

Walk me through how xianyu-auto-reply uses Playwright to keep the WebSocket connection to Xianyu alive automatically.

Prompt 5

I want to run xianyu-auto-reply on Windows as a standalone EXE. What are the steps to package and launch it without Docker?

Open on GitHub → Explain another repo

← zhinianboke on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.