What is this project?

I recently browsed GitHub and stumbled upon an interesting project: 23Star/xianyu-super-butler, named "Xianyu Super Butler."

In short, it's an automated backend tool designed to manage Xianyu messages, orders, and shipping. You can think of it as a combination of a "Xianyu customer service bot + shipping assistant + order dashboard."

It’s primarily suited for those running side hustles on Xianyu, especially sellers of digital goods such as e-books, vouchers, tutorials, templates, and resource packs. The main pain point isn’t production—it’s repetitive tasks like replying to messages, manually sending files, and checking order statuses. Handling ten orders a day is manageable, but when it hits dozens, your hands start questioning their existence.

What Can It Do?

The core functionalities include:

1. Automated Responses

You can set up keyword-based replies. For example, when buyers ask:

“Are you available?”
“How do I get the product?”
“Can you lower the price?”
“When will you ship?”

The system automatically matches keywords and sends pre-defined responses. It supports default replies, product-specific replies, and AI-powered negotiation logic. This means when a buyer tries to haggle, the system can respond according to your configured discount rules—no need to copy-paste every time.

2. Automated Shipping

This is arguably the most valuable feature.

It supports voucher management, shipping rules, multi-variant products, and delayed shipping. For instance, if you sell an “Excel Auto-Tracking Template,” once a buyer places an order, the system can automatically send the cloud storage link, extraction code, or redemption code based on the product title or rule set.

This is extremely beneficial for digital product vendors. Imagine someone places an order at 2 a.m., while you’re fast asleep—your automation engine keeps working even when you're offline.

Order Management

The backend allows viewing order lists, order details, order status, and supports batch refreshes. It also includes a “Ship Now” function for manual re-shipping.

For example, if you’ve already sent the file but forgot to mark it as shipped on Xianyu, you can select “Update Only Xianyu Shipping Status.”
If neither the file nor the status was updated, choose “Full Ship” to trigger the system to match the correct voucher and dispatch it automatically.

Multi-Account Management

It supports multiple Xianyu accounts with options for QR code login, password login, or manual Cookie input. This is highly practical for users managing several accounts simultaneously.

What Tech Stack Is Used?

Backend technologies include:

• Python 3.11+
• FastAPI
• SQLite
• Playwright
• WebSocket
• Asyncio

Frontend technologies include:

• React
• TypeScript
• Vite
• Tailwind CSS
• Zustand
• Framer Motion / Charting Components

Simply put:
The backend handles Xianyu API connections, message processing, order management, and automated shipping; the frontend provides a visual dashboard so you don’t have to operate via a black terminal window.

Example: Automating Xianyu Shipping

Suppose I’m selling a “Side Hustle Excel Tracker Template” priced at 19.9 RMB.

Previously, the workflow might look like this:

1. Buyer asks: “How do I use this?”
2. I reply: “After purchase, I’ll send the cloud drive link.”
3. Buyer asks: “Can you reduce the price?”
4. I say: “Minimum is 18.”
5. Buyer places the order.
6. I open the chat, copy the cloud link and extraction code.
7. I go to the order page and click “Ship.”
8. If I’m eating, sleeping, or in a meeting, the buyer may follow up: “Boss, has it been shipped?”

With this project, the process becomes:

1. Buyer asks “How do I use it”—system auto-replies with instructions.
2. Buyer negotiates—the system applies predefined pricing rules automatically.
3. After purchase, the system detects the order.
4. It matches the shipping rule for “Side Hustle Excel Tracker Template.”
5. Automatically sends cloud link and extraction code.
6. Marks the order as shipped automatically.

Now you transition from being a manual customer service agent to a backend operator. Of course, you still need to configure rules upfront and periodically review anomalies.

How to Use This Project?

Step 1: Clone the Repository

Command: git clone https://github.com/23Star/xianyu-super-butler.git cd xianyu-super-butler

Step 2: Install Python Dependencies

Project requires Python 3.11+.

Command: pip install -r requirements.txt

You also need to install Playwright browser:

Command: playwright install chromium

On Linux servers, you may additionally need:

Command: playwright install-deps chromium

Step 3: Build Frontend

Command: cd frontend npm install npm run build cd ..

Step 4: Start the Service

Command: python Start.py

After startup, open your browser at:

http://localhost:8080

Default login credentials are:

Username: admin Password: admin123

Change the password immediately after first login. This isn’t just a recommendation—it’s a critical security measure.

Step 5: Add Xianyu Accounts

After logging into the dashboard, you can add Xianyu accounts. The project supports QR code login, password login, and manual Cookie input.

Only after adding accounts can the system monitor messages, sync orders, and execute automated replies and shipping.

Step 6: Configure Keywords and Shipping Rules

For example, if you sell “Excel Templates,” you can configure as follows:

Keyword Responses:

Keyword: “How to use” ---- Reply: “After purchase, the cloud drive link will be automatically sent, including the template and usage guide.”

Shipping Rules:

Match Product: Side Hustle Excel Tracker Template Shipping Content: Cloud Link + Extraction Code

If you sell multi-variant products (e.g., Basic / Advanced / Premium versions), you can define different shipping content for each variant.

My Personal Experience Summary

After reviewing this project, I believe its core value lies in transforming a Xianyu side hustle from a manual, labor-intensive operation into a semi-automated micro-backend system.

It’s not a one-click wealth generator, nor a mythical “passive income” tool. Its true value is eliminating repetitive tasks: less idle chit-chat, fewer link copies, fewer missed shipments.

It’s best suited for:

Who Should Use It?

Digital Product Sellers

Such as those selling resource packs, templates, tutorials, redemption codes, digital assets, or e-documents. These goods are easily standardized and ideal for automated delivery.

Multi-Account Operators

If you manage multiple Xianyu accounts, manually switching between them is tedious. Multi-account management in this project offers significant convenience.

Users with Basic Technical Skills

It’s not a plug-and-play tool for absolute beginners—it requires basic command-line operations like installing Python, running scripts, and configuring accounts. If you’ve never used terminal commands before, you might feel overwhelmed initially, but following the steps carefully should resolve most issues.

Not Ideal for Physical Goods Sellers

If you sell secondhand electronics, furniture, clothing, or other items requiring intense communication, negotiation, and logistics coordination, the automation benefits are limited—though it can still assist with auto-replies.

Final Reminder

The project’s README includes a disclaimer: this tool is intended solely for learning and research purposes. Commercial use is strictly prohibited. Before deployment, always verify platform policies, legal compliance, and account risk levels.

From a learning and productivity standpoint, this project is absolutely worth exploring. It integrates automated replies, order management, voucher delivery, and AI negotiation into a single backend—making it an excellent reference for anyone interested in Xianyu automation.