Automazione delle vendite di prodotti digitali con XianYuAssistant

Vendere chiavi digitali, codici di accesso e piccoli oggetti usati sui marketplace si trasforma rapidamente in una routine monotona. L'acquirente ha pagato il prodotto alle tre di notte, aspettandosi una consegna istantanea, ma tu dormi. Di conseguenza, la valutazione del negozio scende e il cliente va dai concorrenti.

L'autore del repository open-source XianYuAssistant ha deciso di risolvere questo problema per la piattaforma cinese Xianyu (il marketplace secondario di Alibaba). Ha creato una combo completa self-hosted in grado di raccogliere i messaggi in entrata al volo, rispondere agli acquirenti tramite IA e consegnare automaticamente codici promozionali o file dall'inventario.

Perché gli sviluppatori dovrebbero dare un'occhiata

Anche se non vendi nulla su Xianyu, il progetto è interessante per la sua implementazione tecnica. È uno stack moderno su Java 21 e Spring Boot 3.5.7, dove la ricerca vettoriale integrata per le reti neurali, l'automazione del browser e il lavoro WebSocket sono stati portati in produzione reale sotto condizioni antifrode aggressive.

Il sito della piattaforma si difende attivamente dai bot. Per aggirare le restrizioni, l'autore ha applicato un approccio completo:

• Login con QR code usando un browser headless con Playwright.
• Simulazione di ritardi realistici tra le richieste e i refresh dei token.
• Integrazione di un database SQLite locale con storage vettoriale in un singolo file.
• Auto-responder intelligente basato su Spring AI e modello Tongyi Qwen con ricerca nella knowledge base (RAG).

Automazione dei messaggi e consegna delle chiavi

Il flusso di lavoro principale si basa sul monitoraggio continuo del canale WebSocket. Una volta che un acquirente trasferisce il pagamento per un articolo, il servizio rileva istantaneamente lo stato "Pagato" e recupera la chiave corrispondente dall'inventario interno di beni virtuali.

Quando gli acquirenti fanno domande di routine come "Come si attiva?" o "Funziona in Russia?", il servizio non si limita a inviare template. Puoi configurare regole basate su regex o collegare un modello linguistico. Ogni prodotto ottiene un database vettoriale con descrizioni e istruzioni. La rete neurale estrae il frammento di testo rilevante e genera una risposta naturale.

Combattere i blocchi e i captcha slider

L'aspetto più impegnativo di questi progetti è impedire alla piattaforma di bannare l'account per uso di automazione. XianYuAssistant implementa un interessante meccanismo di rotazione delle sessioni:

1. I cookie vengono aggiornati tramite chiamata a un endpoint in background ogni 30 minuti.
2. Il token _m_h5_tk si resetta con un intervallo variabile tra 1,5 e 2,5 ore.
3. Il token WebSocket cambia ogni 10-14 ore.
4. Una pausa di 2-5 secondi viene mantenuta tra le azioni di account multipli.

Se la piattaforma attiva un captcha slider, il sistema registra questo evento e mostra un prompt nel pannello di controllo. L'utente può completare manualmente la verifica attraverso il browser e iniettare cookie freschi senza riavviare completamente il bot.

Architettura e stack tecnologico

Il progetto consiste in un backend monolitico e un frontend Vue 3.5 con Element Plus. Tutto gira in un singolo container Docker, eliminando la necessità di un database separato—SQLite è embedded all'interno della direttiva di mount.

docker run -d \
  --name xianyu-assistant \
  -p 12400:12400 \
  -v $(pwd)/data/dbdata:/app/dbdata \
  -v $(pwd)/data/logs:/app/logs \
  --restart unless-stopped \
  iamlzy/xianyuassistant:latest

I componenti backend notevoli includono:

• Playwright Java: utilizzato per il rendering della pagina di login e la scansione dei QR code.
• Spring AI 1.1.4: gestisce l'integrazione con LLM e lo storage vettoriale senza servizi di terze parti come Pinecone o Qdrant.
• ZXing e MessagePack: utilizzati per la gestione dei codici a barre e la decodifica dei messaggi del protocollo binario.

L'interfaccia è responsive, quindi rispondere ai messaggi o visualizzare i log di consegna è comodo anche da telefono.

Vale la pena installarlo

XianYuAssistant è uno strumento specializzato per chi opera nel mercato asiatico. Tuttavia, il codice sorgente del repository serve come eccellente tutorial per scrivere bot in Java 21 con Spring Boot moderno e Vue 3.

Se sei interessato a vedere come organizzare la ricerca RAG su un file SQLite locale, gestire messaggi WebSocket binari o configurare la rotazione delle sessioni per evitare i blocchi, questo progetto merita sicuramente un'occhiata più attenta.