achun1107/xianyu-auto-listing
Productivity & UtilitiesTurns a short "city + artist" prompt into a generated listing image, title, and published Xianyu proxy-bidding listing.
What it does
This tool automates the manual work of posting a proxy-bidding (代拍) listing on Xianyu, Alibaba's second-hand marketplace. A user types a short phrase like 广州 王嘉尔 (city + artist), and the tool generates a listing image, writes a title and body copy, fills category, specs, inventory, location and shipping fields, then publishes to the user's shop. Each shop's prices, copy pool and image styles come from a per-shop JSON profile under stores/, so different sellers can keep different strategies.
The repository contains a Node.js core (lib/), command-line tools under tools/ (shop creation, login, material initialization, listing overview, self-check, report collection), and reusable skill packages. The README describes three hard-coded limits: cost per consultation ≤ ¥4, consultation count ≤ 4 and order count ≤ 35, and never touching the "擦亮宝贝" (polish item) plan.
Getting started
There are two paths. Non-technical students follow the five-step student guide: download, extract, double-click install.cmd, double-click 启动.cmd, then type a city + artist phrase. The installation package is obtained from the project download page, and there is a separate installation guide plus an agent-oriented step-by-step install task.
Developers can clone the repository and run the self-check, which needs no third-party npm packages because the core uses only Node built-in modules:
git clone <this repo>
cd xianyu-achun
node tools/verify-student-view.js
After cloning, the two companion repositories xianyu-playwright-service (browser/8093 service) and xianyu-monitor (publishing and ads execution) must be placed as sibling directories of xianyu-achun; the installer looks for them by fixed names, so renaming or moving breaks the dry run. Login requires scanning a QR code, passing a slider check and entering an SMS code, which must be done by a human.
Usage constraints
The tool requires Node.js 18+ and the two companion services; without xianyu-monitor, publishing fails silently. Image generation through the optional museav CLI uses a Dalian base image when absent. One Xianyu account can only run on one machine, each shop needs its own QR login, and first-time installation takes 5–15 minutes because a Chromium build is downloaded. An error containing -9 means the listing is under review (typically 10–30 minutes) and should not be republished. The 8093 service reclaims context after 20 idle minutes and can be warmed up again.
Sensitive retail data — shop profiles, ad records and account notes — is excluded via .gitignore; the README states a 2026-11-13 incident in which the working directory was briefly pushed publicly, exposing account UUIDs, a phone number and a middleware key prefix. The repository has no declared license, and the README notes it is a public mirror of a private GitLab main repository.
HotRepo's take
The project appeared on HotRepo's new JavaScript list on 2026-11-16 with 178 stars and 14 forks, a net gain of 38 stars over roughly 19 hours from the 2026-11-15 snapshot window. The star curve was flat at 140 through that window and jumped at the last sample, so there is not enough same-scope data to describe a trend. The README's claim of a one-minute listing versus 30–45 minutes manually is the author's estimate, not an independently measured result.
Written by AI from the project's README, updated . The project's own docs are the source of truth.