Automatización de ventas de productos digitales con XianYuAssistant

Vender claves digitales, códigos de acceso y artículos pequeños usados en marketplaces rápidamente se convierte en una rutina monótona. El comprador pagó por el producto a las tres de la mañana, esperando entrega instantánea, pero tú estás dormido. Como resultado, la calificación de la tienda baja y el cliente se va con la competencia.

El autor del repositorio de código abierto XianYuAssistant decidió resolver este problema para la plataforma china Xianyu (el marketplace secundario de Alibaba). Creó una combinación completa y self-hosted que puede captar los mensajes entrantes al instante, responder a los compradores mediante IA y entregar automáticamente códigos promocionales o archivos del inventario.

Por qué los desarrolladores deberían echarle un vistazo

Incluso si no vendes nada en Xianyu, el proyecto es interesante por su implementación técnica. Es un stack moderno con Java 21 y Spring Boot 3.5.7, donde la búsqueda vectorial integrada para redes neuronales, la automatización de navegadores y el trabajo con WebSocket se pusieron en producción real bajo condiciones agresivas contra fraudes.

El sitio web de la plataforma se defiende activamente contra bots. Para sortear las restricciones, el autor aplicó un enfoque integral:

• Inicio de sesión con código QR usando un navegador headless con Playwright.
• Simulación de retrasos realistas entre solicitudes y renovaciones de tokens.
• Integración de una base de datos SQLite local con almacenamiento vectorial en un solo archivo.
• Auto-respondedor inteligente basado en Spring AI y el modelo Tongyi Qwen con búsqueda en base de conocimientos (RAG).

Automatización de mensajes y entrega de claves

El flujo de trabajo principal se basa en el monitoreo continuo del canal WebSocket. Una vez que el comprador transfiere el pago del artículo, el servicio detecta instantáneamente el estado "Pagado" y recupera la clave correspondiente del inventario interno de productos virtuales.

Cuando los compradores hacen preguntas rutinarias como "¿Cómo activo esto?" o "¿Funciona en Rusia?", el servicio no solo envía plantillas. Puedes configurar reglas basadas en regex o conectar un modelo de lenguaje. Cada producto tiene una base de datos vectorial con descripciones e instrucciones. La red neuronal extrae el fragmento de texto relevante y genera una respuesta natural.

Luchando contra bloqueos y captchas deslizantes

El aspecto más desafiante de estos proyectos es evitar que la plataforma bloquee la cuenta por usar automatización. XianYuAssistant implementa un interesante mecanismo de rotación de sesiones:

1. Las cookies se renuevan mediante una llamada a un endpoint en segundo plano cada 30 minutos.
2. El token _m_h5_tk se reinicia con un intervalo variable entre 1.5 y 2.5 horas.
3. El token WebSocket cambia cada 10–14 horas.
4. Se mantiene una pausa de 2–5 segundos entre las acciones de múltiples cuentas.

Si la plataforma activa un captcha deslizante, el sistema registra este evento y muestra un aviso en el panel de control. El usuario puede completar manualmente la verificación a través del navegador e inyectar cookies frescas sin reiniciar completamente el bot.

Arquitectura y stack tecnológico

El proyecto consiste en un backend monolítico y un frontend Vue 3.5 con Element Plus. Todo se ejecuta en un único contenedor Docker, eliminando la necesidad de una base de datos separada: SQLite está embebido dentro de la directiva de montaje.

Los componentes destacados del backend incluyen:

• Playwright Java: se utiliza para renderizar la página de inicio de sesión y escanear códigos QR.
• Spring AI 1.1.4: maneja la integración con LLM y almacenamiento vectorial sin servicios de terceros como Pinecone o Qdrant.
• ZXing y MessagePack: se utilizan para el manejo de códigos de barras y la decodificación de mensajes de protocolo binario.

La interfaz es responsive, por lo que responder mensajes o ver los registros de entrega es conveniente incluso desde un teléfono.

¿Vale la pena instalar?

XianYuAssistant es una herramienta especializada para quienes operan en el mercado asiático. Sin embargo, el código fuente del repositorio sirve como un excelente tutorial para escribir bots en Java 21 con Spring Boot moderno y Vue 3.

Si te interesa ver cómo organizar búsqueda RAG en un archivo SQLite local, manejar mensajes WebSocket binarios o configurar la rotación de sesiones para evitar bloqueos, este proyecto definitivamente merece un vistazo más cercano.