cv-cat/XianYuApis

What it solves

This project provides a third-party API integration library for the XianYu (闲鱼) platform, enabling developers to build AI-powered customer service agents. Since the official platform does not provide open IM message interfaces, this library solves the critical problem of stably receiving and sending messages to integrate with LLMs like GPT, Claude, or local models.

How it works

It reverse-engineers the XianYu WebSocket private message protocol (including sign signatures, base64, and Protobuf) and decrypts the HTTP interfaces. It provides a unified abstraction layer for message handling, allowing developers to connect an "AI brain" (LLM/RAG) to the platform's "nerves" (the messaging system).

Who it’s for

Developers building automated AI customer service bots or management systems for XianYu sellers who want 24/7 automated responses.

Highlights

• Full Message Capability: Supports real-time sending and receiving of text and image messages via WebSocket.
• Session Management: Ability to retrieve full chat histories and product details.
• Token Maintenance: Automatically refreshes login states to keep the process running without disconnection.
• AI-Ready: Specifically designed as a foundation for AI agents, with a clear entry point for integrating LLM reply logic.