AI Frameworks · shaxiu

XianyuAutoAgent

XianyuAutoAgent is a Python-based AI customer service automation system built for Alibaba's Xianyu (闲鱼) marketplace platform. It provides 24/7 automated customer support with multi-expert routing, intelligent price negotiation, and context-aware conversations using LLM backends.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/shaxiu/XianyuAutoAgent

8.3k

GitHub stars

1.5k

Forks

Python

Primary language

GPL-3.0

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	shaxiu/XianyuAutoAgent
Owner	shaxiu
Primary language	Python
License	GPL-3.0 — OSI-approved
Stars	8.3k
Forks	1.5k
Open issues	49
Latest release	Unknown
Last updated	2026-06-10
Source	https://github.com/shaxiu/XianyuAutoAgent

What XianyuAutoAgent is

Built on Python 3.8+ with LLM integration (default: Aliyun Qwen), featuring prompt-based intent routing, stateful conversation history management, modular expert agents (pricing, technical support, default), and web cookie-based marketplace authentication. Uses rule-based + LLM hybrid dispatching for scenario detection.

Quickstart

Get the XianyuAutoAgent source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/shaxiu/XianyuAutoAgent.git2cd XianyuAutoAgent3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Xianyu Marketplace Automation

Direct fit for Alibaba Xianyu sellers needing autonomous customer interaction, negotiation, and support across multiple product inquiries during off-hours.

Multi-Expert Agent Orchestration

Demonstrates modular LLM agent design with context-aware routing (classify → price specialist, tech specialist, or general support) applicable to other e-commerce or marketplace platforms.

Proof-of-Concept for AI Customer Support

Lightweight reference implementation for startups exploring LLM-driven customer service without building infrastructure from scratch; includes pricing strategy, web search integration, and logging.

Implementation considerations

Requires valid Xianyu web credentials (cookies) and LLM API key (Qwen or compatible); no built-in secret rotation or credential lifecycle management.
Prompt-based routing may exhibit brittleness or inconsistency under novel input patterns; consider A/B testing and monitoring classification accuracy metrics.
Session state stored in-memory by default; no distributed session backend documented, limiting horizontal scaling or multi-process deployments.
Custom prompts must be created or templates de-suffixed from examples; no versioning or rollback mechanism for prompt updates.
Basic logging only; production use requires instrumentation for conversation analytics, error tracking, and audit trails before handling sensitive customer data.

When to avoid it — and what to weigh

GPL-3.0 Incompatibility with Proprietary Products — If your system or planned commercial product cannot be released under GPL-3.0 or linked to GPL-3.0 code, this project is unsuitable without explicit commercial licensing negotiation with the author.
Non-Xianyu Platforms or Regulated Markets — This system is tightly coupled to Xianyu's web API and cookie authentication. Porting to other e-commerce platforms or regulated sectors (finance, healthcare) requires substantial refactoring and legal/compliance review.
Production Enterprise Deployments — Early-stage project (created 2025-03-14) with no versioned releases, basic logging only, no WAF/DDoS protection, and author disclaimers of potential stoppage or deletion. High operational risk without vendor support.
High-Availability SLAs — No documented disaster recovery, clustering, or failover mechanisms. Suitable only for experimental or low-stakes workloads; not appropriate for revenue-critical customer interactions.

License & commercial use

GPL-3.0 (GNU General Public License v3.0). This is a copyleft license requiring any derivative work or linked product to also be released under GPL-3.0 and source made available. Commercial use is possible but only if the entire product stack complies with copyleft obligations.

Commercial use is legally permitted under GPL-3.0 *only if* your system, including all integrations, is released under GPL-3.0 and source code is made available to customers/users. If you plan a proprietary SaaS or closed-source product, you must either: (1) negotiate a separate commercial license with the original author, or (2) rewrite without GPL code. No explicit commercial license grant is stated in the repository; contact [email protected] for licensing options. Requires legal review before commercial deployment.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Needs review
Deployment complexity	Moderate
DEV.co fit	Good
Assessment confidence	Medium

Security considerations

Credentials (API_KEY, COOKIES_STR) stored in .env file in plaintext; no documented secret rotation or credential scoping. LLM prompts may be vulnerable to injection attacks; no input sanitization or output filtering visible. Cookie-based auth is session-level, subject to credential theft if development machine or CI/CD is compromised. No rate limiting, request signing, or API authentication hardening documented. Xianyu ToS compliance and PII handling unclear; exercise caution before processing real customer data.

Alternatives to consider

Langchain / LangSmith

Platform-agnostic LLM agent framework with production-ready multi-expert routing, memory backends, and observability. Steeper learning curve but no platform lock-in (Xianyu-specific).

Alibaba DingTalk Bot SDK + AI API

Official Alibaba ecosystem solution integrating Ding Talk, Xianyu APIs, and Aliyun LLM services. Likely better support, documentation, and compliance but may require managed service licensing.

Rasa

Open-source conversational AI platform with NLU, dialogue management, and multi-channel integration. More mature, documented, and Apache-licensed, but heavier deployment footprint and less LLM-native.

Software development agency

Build on XianyuAutoAgent with DEV.co software developers

XianyuAutoAgent is a lightweight proof-of-concept for LLM-driven customer automation. If you need production-grade integration, custom model tuning, or multi-platform deployment (beyond Xianyu), our AI/eCommerce teams can help architect a compliant, scalable solution. Contact us to discuss your use case and licensing strategy.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

inference Qwen3-235B-A22B Qwen3-235B-A22B-Instruct-2507

Related on DEV.co

Explore the category and the services that help you build with it.

AI Frameworks AI Application Development eCommerce Development Custom Software Development Talk to DEV.co

XianyuAutoAgent FAQ

Can I use this in a SaaS product?

Only if your entire SaaS stack (including product code) is released under GPL-3.0. Otherwise, you must negotiate a separate commercial license with the author. Requires legal review before proceeding.

What LLM models are supported?

Default is Aliyun Qwen. Any LLM with an OpenAI-compatible API endpoint can be configured via MODEL_BASE_URL and MODEL_NAME in .env. No built-in support for other providers documented.

How is conversation history managed?

Stored in-memory during runtime. No persistent database, clustering support, or session recovery documented. Suitable for single-process, experimental deployments only.

What happens if the author stops maintaining this?

Author explicitly disclaims ongoing maintenance and reserves right to delete the project. You must fork and maintain internally if production-critical. Community contributions welcome via PR, but no SLA.

Software development & web development with DEV.co

From first prototype to production, DEV.co delivers software development services around tools like XianyuAutoAgent. Our software development agency staffs experienced software developers and web developers for custom software development, web development, integrations, and ongoing support across ai frameworks and beyond.

Ready to Automate Your Marketplace Support?

Talk to DEV.co Schedule a Consultation