cv-cat/XianYuApis

What it solves

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

How it works

The library reverse-engineers the XianYu WebSocket private message protocol (including sign signatures, base64, and Protobuf) and decrypts the HTTP interfaces. It provides a unified message transmission abstraction layer that handles the complex communication protocols, allowing developers to focus on the business logic of their AI agent's "brain."

Who it’s for

Developers building automated customer service bots or AI agents for XianYu sellers who want 24/7 automated interaction with potential buyers.

Highlights

• Full Communication Suite: Supports real-time WebSocket messaging, HTTP API calls, and session management.
• Multi-modal Support: Handles both text and image messages.
• Session Persistence: Includes automatic token refreshing 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-based reply logic.