Traxo: tu e-commerce operado desde Claude

Traxo es un agente open source que opera tu tienda online. Cuando entra un pedido cotiza entre las transportadoras, elige la mejor y te explica por qué, confirma por WhatsApp las contraentregas de riesgo, genera la guía, la escribe en tu tienda, vigila el envío y atiende las novedades. También audita tu tienda, arma borradores de campañas con tus propios videos y fotos, y te dice cuánto trabajó el agente y cuánto costó.

Se instala como plugin de Claude Code y trae su propio panel web. Corre en tu computador o en tu Railway, así que tus datos y tus llaves no salen de tu servidor. Hoy soporta Colombia (pesos, códigos DANE, teléfonos +57, Ley 1581 de datos personales). México es el siguiente mercado en el roadmap y cualquiera puede sumar el suyo.

Las reglas del juego son tres y valen para todo lo que viene: lo que gasta, publica o borra espera tu sí; lo que no se puede medir sale como N/A y no como un número inventado; y las campañas siempre nacen en pausa.

Las cuatro piezas

El recorrido de un pedido

Así se ve el seguimiento cuando todo está conectado. Nada de esto lo haces tú a mano, pero conviene saber en qué paso estás cuando algo te llega a Aprobaciones.

1. 1

   Entra el pedido

   Traxo valida la dirección contra los códigos DANE, puntúa el riesgo de la contraentrega y cotiza en todas las vías a la vez.

2. 2

   Elige y explica

   Gana la transportadora con mejor costo total (flete más comisión de recaudo), tiempo y confiabilidad. Si el riesgo es alto, antes de gastar en una guía le escribe al cliente: que confirme, que pague ahora con descuento o que cambie la dirección. Sin respuesta en 24 horas te lo pasa a ti.

3. 3

   Genera la guía

   Solo si está dentro del tope que fijaste. La escribe de vuelta en Shopify, Tiendanube o WooCommerce.

4. 4

   Vigila cada guía

   Recibe los eventos de la transportadora, actualiza la línea de tiempo y le avisa al cliente que llega hoy y cuánto tener listo.

5. 5

   Atiende las novedades

   Si la entrega falla, le escribe al cliente por su canal. Un sí, mañana estoy reprograma sola; una dirección nueva te llega a Aprobaciones.

6. 6

   Todo queda registrado

   Actividad guarda lo que hizo el agente, Mensajes lo que se dijo y Pedidos el recorrido. Y puedes preguntarle al Agente del panel.

Cuatro palabras de oficio

El instalador te va a preguntar casi todo esto, pero llegar con las respuestas pensadas te ahorra media hora. Y ninguna es definitiva: puedes volver a correr el instalador cuando quieras y no pisa lo que ya configuraste.

Lo que tiene que estar en tu computador

• Claude Code, la app o la terminal.
• Node 24 o superior. Si te dice que no lo tienes, el asistente te explica cómo instalarlo con nvm.
• git.
• pnpm: el asistente lo activa solo con corepack si falta.

Decisión 1: dónde lo corres

Decisión 2: qué plataforma usa tu tienda

Shopify, Tiendanube o WooCommerce tienen integración. Si todavía no tienes tienda o prefieres conectarla después, se instala igual y la tienda de ejemplo del modo demo te deja ver todo funcionando.

Decisión 3: con qué envías

Envia.com es hoy la única vía con integración real: cotiza, genera guías y recibe el tracking de Coordinadora, Servientrega, Interrapidísimo, TCC y otras. 99envios y las transportadoras directas corren simuladas, porque no tienen documentación pública o piden contrato. Traxo te lo dice cada vez, para que no confundas un precio simulado con uno real.

Qué llaves vas a necesitar, según lo que actives

Esto es lo único de la guía que se escribe en una terminal. El primer comando agrega el catálogo de Traxo a Claude Code y el segundo instala el plugin. Después todo pasa dentro de Claude Code, hablando.

Abre Claude Code (la app o con el comando claude en una carpeta donde quieras tener Traxo) y escribe esta línea. Es la que arranca el asistente de instalación:

Qué hace el asistente por ti

1. 1

   Prepara el proyecto

   Clona el repo, revisa que tengas Node 24 y pnpm, instala las dependencias y compila el panel. Si algo falla, lo resuelve antes de seguir.

2. 2

   Te hace las preguntas

   Dónde lo quieres correr, qué plataforma usa tu tienda, con qué envías, tu correo de acceso, tu dirección de despacho y qué más activar (Zernio, Wompi, tu llave de Claude).

3. 3

   Crea tu archivo .env

   Con lo que no es secreto. Los secretos propios (sesiones, token de /mcp, contraseña de administrador) los genera él. Las llaves de terceros quedan en blanco con una nota de dónde conseguir cada una.

4. 4

   Tú pegas tus llaves

   Abres el .env en tu editor, pegas cada valor después del igual y guardas. Si todavía no tienes alguna, queda pendiente y se sigue.

5. 5

   Revisa que todo funcione

   Corre pnpm doctor. Cada línea sale con una marca: visto bueno, falla (hay que arreglar), un guion si es opcional y no la pusiste, o un aviso que no bloquea. Repite hasta que no quede ninguna falla.

6. 6

   Lo arranca y te da el primer día

   En local lo levanta en localhost:8787; en Railway crea el proyecto, la base, las variables, el volumen y el dominio con tu sí. Te da las direcciones de webhook y conecta Claude con las herramientas.

Instala Traxo para mi negocio.

Mi tienda está en [Shopify / Tiendanube / WooCommerce / todavía no tengo].
Envío con [Envia.com / otra transportadora / todavía no envío].
Quiero correrlo [en mi computador para probar / en Railway para dejarlo siempre encendido].

Antes de hacer nada:
1. Dime qué vas a hacer en cada paso, en una frase.
2. No me pidas ninguna llave por el chat ni abras mi archivo .env. Yo las pego a mano.
3. No actives nada de pago (Wompi, anuncios, Railway) sin preguntarme.

Al terminar, dame una lista corta de lo que quedó listo, lo que quedó pendiente y el siguiente paso.

La instalación de Traxo falló o quedó a medias.

Revisa en qué paso quedamos (pnpm install, pnpm build, el .env o pnpm doctor), lee el error y explícame en una frase qué pasó. Arréglalo y vuelve a verificar antes de seguir.

Reglas: no me pidas llaves por el chat, no abras mi .env (para saber si algo quedó bien usa solo pnpm doctor) y si necesitas instalar algo en mi computador, dime qué es antes.

Antes de poner tus llaves, mira Traxo con datos de mentira. El modo demo arranca con una tienda llamada Café de Origen y 90 días de operación simulada: pedidos, guías, mensajes y campañas, para que el panel salga lleno. Todo es simulado, ningún WhatsApp ni guía sale de verdad.

Entras con la cuenta de ejemplo (admin@traxo.demo y la contraseña traxo-demo) y hay un recorrido guiado. Es ideal para enseñarle el sistema a un socio o para decidir si te sirve.

Levanta Traxo en modo demo en mi computador (TRAXO_DEMO=1 pnpm start) y abre http://localhost:8787.

Dime con qué correo y contraseña entro. Luego recórreme el panel en este orden: Inicio, Pedidos (abre uno y enséñame cómo se eligió la transportadora), Aprobaciones y Marketing. Para cada pantalla dime en una frase para qué la usaría un dueño de tienda.

Recuerda: es una tienda de ejemplo, nada de esto es real.

El panel es para mirar. Para conversar con tu negocio desde Claude Code necesitas conectarlo a las 41 herramientas de Traxo, y eso se hace una sola vez. El instalador ya lo hace, pero si lo saltaste o cambiaste de computador, aquí está a mano.

Llama a traxo_estado y dime, en una lista corta, qué conexiones están reales y cuáles simuladas (tienda, envíos, WhatsApp, pagos, IA).

Después corre listar_pedidos y listar_productos: si ves datos de mi tienda, la conexión está bien; si ves datos de ejemplo, dímelo.

Una skill es un comando que empieza con /traxo: y le da a Claude las instrucciones de un trabajo concreto. No tienes que memorizarlas: también se activan solas cuando dices frases como dónde va mi pedido o audita mi tienda. Pero saber cuáles hay te dice qué le puedes pedir.

Para empezar y conectar

Para operar la tienda

Para crecer

Los cuatro agentes

Un agente es un especialista que Claude puede llamar para una tarea, con acceso solo a las herramientas que le tocan. Se activan solos según lo que pidas.

Cuánta libertad le das

Todos se pegan en Claude Code con Traxo ya conectado. Los corchetes son lo que cambias por lo tuyo. Están escritos para que Claude use las skills correctas y respete las reglas de la casa: sin llaves en el chat, nada de gastar sin tu sí y N/A en vez de cifras inventadas.

Usa /traxo:start para dejar Traxo listo.

1. Dime qué está real y qué simulado.
2. Si mi tienda no está importada, impórtala.
3. Hazme, de una sola vez, las preguntas que falten: qué vendo y a quién, con qué transportadoras trabajo, qué porcentaje de mis pedidos es contraentrega y desde qué ciudad despacho. Anótalo en negocio.md.
4. Déjame la autonomía en 0 (todo con mi aprobación) y explícame en dos frases qué cambiaría si la subo a 1.

No gastes nada ni le escribas a ningún cliente.

Resúmeme el estado de mi operación con /traxo:pedidos y /traxo:seguimiento.

Empieza por lo que se está perdiendo hoy: aprobaciones pendientes, novedades abiertas y recaudo por cobrar. Después los pedidos nuevos que esperan guía. Para cada cosa dime el número de pedido, el monto en pesos y qué decisión necesitas de mí.

No generes ninguna guía ni le escribas a ningún cliente todavía; solo muéstrame el plan.

Revisa el pedido #[número] y cotiza el envío con las transportadoras disponibles.

Dime cuál elegirías y por qué, con los números: costo total con recaudo, días hábiles y confiabilidad. Avísame si alguna cotización es simulada y no real.

Si la dirección no tiene vía y número, pídeme la corrección en vez de cotizar. No generes la guía hasta que yo te diga que sí.

Quiero confirmar por WhatsApp las contraentregas de riesgo antes de generar la guía.

Usa configurar_confirmacion en modo risky. Antes de aplicarlo, muéstrame qué cambia: qué le va a decir al cliente, qué opciones le da (confirmar, pagar ahora con descuento, cambiar la dirección o cancelar) y qué pasa si no contesta en 24 horas.

Dime también si WhatsApp está conectado de verdad o simulado.

¿Dónde va el pedido #[número]? Rastrea la guía y dime el estado actual, los últimos eventos de la transportadora y, si hay novedad, qué le escribió Traxo al cliente y qué respondió.

Si falta algo que yo deba decidir, dímelo al final en una línea.

Quiero escribirles a mis clientes inactivos para que vuelvan a comprar. Usa /traxo:clientes.

1. Segmenta a los inactivos y dime cuántos hay y cuántos quedan fuera por no tener consentimiento.
2. Redáctame un mensaje corto, de tú, con una sola invitación y sin urgencias falsas.
3. Muéstrame el texto y a cuántos llegaría. No envíes nada hasta que yo diga que sí.

Si WhatsApp está simulado, avísame al empezar.

Hazme el reporte semanal con /traxo:reportes: ventas, qué campaña trajo qué pedidos y cómo le fue a cada transportadora.

Primero lo que cuesta plata: campañas con ROAS menor a 1, transportadoras con muchas novedades o devoluciones y recaudo en ruta. Cada afirmación con su número. Si no conoces el gasto de algo, ponlo como N/A. Si una transportadora tiene menos de 10 envíos, dime que el dato es poco confiable.

Termina con una sola acción. No pauses ni actives nada tú.

Audita mi tienda [URL pública] con /traxo:tienda: primero SEO y visibilidad en IA, luego diseño y conversión.

Dame el puntaje diciendo sobre cuántos checks se calculó y nombra lo que quedó en N/A. Cada hallazgo con el dato que lo disparó. Termina con Empieza por aquí: las cuatro primeras acciones, ordenadas por impacto, y cuánto tardaría la primera.

Propón, no edites nada de mi tienda.

Arma una campaña con /traxo:campana para [producto] en [Meta / Google / TikTok], con presupuesto diario de [monto] para [ciudades].

Primero revisa mi biblioteca de creativos y usa lo que ya tengo. Si falta algo, dime qué generarías con Higgsfield y cuánto costaría en créditos, y espera mi sí. Una sola generación por petición.

Déjala como borrador. Nada se crea en la plataforma ni se activa sin que yo lo diga, y si se crea, nace en pausa.

Diseña mi tienda con /traxo:constructor.

Estilo: [cálido / limpio / audaz / premium]. Tono: [tono]. Ofrezco contraentrega: [sí / no]. Tengo WhatsApp: [sí / no].

Muéstrame primero el borrador antes de exportar nada. Si subes el tema a Shopify, que sea sin publicar, y si usas GitHub, que sea privado. Publicarlo lo decido yo.

En local Traxo revisa tu tienda cada cierto tiempo. En Railway tiene una dirección pública y recibe los avisos en el momento: un pedido nuevo, un evento de la transportadora, un mensaje de un cliente. Es lo que necesitas para operar de verdad.

El asistente lo hace por ti, pero crear un proyecto y desplegarlo es una acción sobre una cuenta real, así que te pide un sí explícito antes de empezar.

Lo que se monta

1. 1

   Un proyecto con Postgres

   Railway crea el proyecto y la base de datos donde Traxo guarda todo.

2. 2

   El servicio de la app

   Se sube el repo. El archivo railway.json ya trae el build y la revisión de salud en /health.

3. 3

   Tus variables, sin imprimirlas

   Un script sube tu .env a Railway sin mostrar ningún valor. Puedes correrlo primero en modo prueba para ver solo los nombres. La base de datos apunta sola al Postgres del proyecto.

4. 4

   Un volumen en /data

   Para que los videos y fotos de tu biblioteca de creativos sobrevivan a cada despliegue.

5. 5

   Un dominio público

   Y se comprueba que /health responda.

Quiero pasar Traxo de mi computador a Railway. Usa /traxo:instalar, paso de Railway.

Antes de crear nada, dime exactamente qué vas a crear (proyecto, Postgres, servicio, volumen, dominio) y espera mi sí.

Sube mis variables con el script de railway-vars. Primero hazlo en modo prueba para que yo vea solo los nombres. Nunca abras ni imprimas mi .env.

Al final dame la dirección pública, las direcciones de webhook para mi tienda, Envia.com y Zernio, y el comando para conectar Claude por HTTP, que ejecutaré yo en mi terminal.

Los webhooks

Un webhook es un aviso automático: le dices a tu tienda o a la transportadora a qué dirección escribirle cuando pase algo. Estas son las cuatro direcciones, con tu dominio de Railway en lugar de TU-DOMINIO:

Si prefieres hacerlo tú por la terminal

Traxo está en su versión 0.1.0, del 17 de octubre de 2026. Esta es la foto de hoy, tomada del propio repo:

Colombia hoy, más países después

Todo lo propio de un mercado (moneda, teléfono, direcciones, ley de datos, transportadoras y pagos) se está aislando detrás de una interfaz Market para que sumar un país sea agregar un paquete y no reescribir el agente. México es el candidato natural. Si quieres tu país, el repo pide abrir un issue con el título Mercado y el nombre del país.