Automatizando Vendas de Produtos Digitais com XianYuAssistant

Vender chaves digitais, códigos de acesso e pequenos itens usados em marketplaces rapidamente se torna uma rotina monótona. O comprador pagou pelo produto às três da manhã, esperando entrega instantânea, mas você está dormindo. Como resultado, a avaliação da loja cai e o cliente vai para os concorrentes.

O autor do repositório open-source XianYuAssistant decidiu resolver esse problema para a plataforma chinesa Xianyu (marketplace secundário da Alibaba). Eles criaram uma combinação completa self-hosted que pode captar mensagens recebidas em tempo real, responder aos compradores via IA e entregar automaticamente códigos promocionais ou arquivos do inventário.

Por que desenvolvedores devem olhar para isso

Mesmo que você não venda nada no Xianyu, o projeto é interessante por sua implementação técnica. É uma stack moderna em Java 21 e Spring Boot 3.5.7, onde busca vetorial integrada para redes neurais, automação de navegador e trabalho com WebSocket foram trazidos para produção real sob condições agressivas antifraude.

O site da plataforma defende ativamente contra bots. Para contornar as restrições, o autor aplicou uma abordagem abrangente:

• Login por código QR usando um navegador Headless com Playwright.
• Simulação de atrasos realistas entre requisições e renovações de token.
• Integração de um banco de dados SQLite local com armazenamento vetorial em um único arquivo.
• Auto-respondente inteligente baseado em Spring AI e modelo Tongyi Qwen com busca em base de conhecimento (RAG).

Automatizando Mensagens e Entrega de Chaves

O fluxo de trabalho principal depende do monitoramento contínuo do canal WebSocket. Assim que um comprador transfere o pagamento de um item, o serviço detecta instantaneamente o status "Pago" e recupera a chave correspondente do inventário interno de produtos virtuais.

Quando compradores fazem perguntas rotineiras como "Como ativo isso?" ou "Funciona na Rússia?", o serviço não apenas envia modelos. Você pode configurar regras baseadas em regex ou conectar um modelo de linguagem. Cada produto recebe um banco de dados vetorial com descrições e instruções. A rede neural puxa o fragmento de texto relevante e gera uma resposta natural.

Lutando contra Bloqueios e Captchas de Slider

O aspecto mais desafiador desses projetos é impedir que a plataforma ban a conta por usar automação. XianYuAssistant implementa um mecanismo interessante de rotação de sessão:

1. Cookies são renovados via chamada de endpoint em segundo plano a cada 30 minutos.
2. O token _m_h5_tk reseta com um intervalo flutuante entre 1,5 e 2,5 horas.
3. O token WebSocket muda a cada 10–14 horas.
4. Uma pausa de 2–5 segundos é mantida entre ações de múltiplas contas.

Se a plataforma acionar um captcha de slider, o sistema registra esse evento e exibe um prompt no painel de controle. O usuário pode completar manualmente a verificação pelo navegador e injetar cookies frescos sem reiniciar o bot completamente.

Arquitetura e Stack de Tecnologias

O projeto consiste em um backend monolítico e um frontend Vue 3.5 com Element Plus. Tudo roda em um único container Docker, eliminando a necessidade de um banco de dados separado — o SQLite é embutido dentro da diretiva de montagem.

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

Componentes notáveis do backend incluem:

• Playwright Java: usado para renderizar a página de login e escanear códigos QR.
• Spring AI 1.1.4: gerencia integração com LLM e armazenamento vetorial sem serviços de terceiros como Pinecone ou Qdrant.
• ZXing e MessagePack: usados para manipulação de códigos de barras e decodificação de mensagens de protocolo binário.

A interface é responsiva, então responder mensagens ou visualizar logs de entrega é conveniente até mesmo de um celular.

Vale a pena instalar

XianYuAssistant é uma ferramenta especializada para quem negocia no mercado asiático. No entanto, o código-fonte do repositório serve como um excelente tutorial para escrever bots em Java 21 com Spring Boot moderno e Vue 3.

Se você está interessado em ver como organizar busca RAG em um arquivo SQLite local, lidar com mensagens WebSocket binárias ou configurar rotação de sessão para evitar bloqueios, este projeto definitivamente merece um olhar mais atento.