ShopiUP es una aplicación nativa de Shopify que conecta a la tienda del comerciante, lee su catálogo y propone mejoras de SEO en producto a producto: títulos optimizados, descripciones más persuasivas, schema enriquecido y alt text de imágenes. El segundo despliegue del producto (v2) fue reescrito desde cero como app embebida con OAuth de Shopify y arquitectura serverless en Cloud Run. Toda la implementación se hizo con Claude Code como copiloto de ingeniería.
El problema: SEO de catálogo en Shopify es un cuello de botella eterno
Cualquier comerciante con un catálogo de más de 100 productos en Shopify llega rápido a la misma pared: actualizar títulos, descripciones, alt text y schema producto a producto es una tarea manual interminable. Las apps existentes hacen "bulk edit" pero no entienden el negocio — terminas con plantillas genéricas que Google ignora.
Quisimos resolver esto con una app que no solo aplica reglas, sino que entiende el producto: lee la categoría, las variantes, el precio, el público objetivo y genera contenido optimizado para SEO y conversión que pasa por aprobación humana antes de aplicarse.
La solución: app embebida que vive dentro del admin de Shopify
ShopiUP es una app nativa publicada en el Shopify App Store. El comerciante la instala en un clic, autoriza OAuth, y desde el primer minuto puede correr una auditoría de su catálogo. La interfaz vive embebida en el admin de Shopify usando App Bridge y Polaris, así que no hay disrupción visual: el comerciante no siente que está cambiando de herramienta.
El flujo de trabajo es de revisión humana: la app propone cambios producto por producto (o en bulk con filtros), el comerciante aprueba o edita, y solo entonces se escriben de vuelta al catálogo vía Admin API. Todo queda auditable.
Stack técnico desplegado en GCP
Backend Node + Express corriendo en Cloud Run (us-central1). OAuth de Shopify con verificación de HMAC en cada webhook. Firestore para guardar el estado por shop (tokens, configuración, historial de cambios). Tareas pesadas (procesar catálogos grandes) se delegan a Cloud Tasks para evitar timeouts del request HTTP.
El frontend embebido usa el SDK de Shopify App Bridge para integrarse al admin. Las propuestas de copy las genera un cliente LLM (Vertex AI Gemini 2.5) con prompts ajustados por categoría de producto y mercado del comerciante (idioma, moneda, tono).
Logging estructurado en Cloud Logging con trace IDs para poder seguir un pedido del comerciante de punta a punta. Errores no recuperables disparan alertas a Slack vía Cloud Functions.
Cómo Claude Code aceleró el desarrollo
El equivalente comercial de "construir una app de Shopify" suele tomarle a una agencia 4-6 meses entre OAuth, webhooks, integración con Admin API, manejo de tokens, escalabilidad y aprobación en el App Store. Con Claude Code la primera versión funcional estuvo lista en pocas semanas.
Lo más valioso fue cómo Claude Code manejó la complejidad de los webhooks de Shopify: verificación HMAC, idempotencia, rate limits, errores transitorios y deduplicación. Esos detalles son la diferencia entre una app que pasa la revisión de Shopify y una que es rechazada — Claude los resolvió correctamente en la primera iteración porque tenía contexto del documentation crawl que hizo antes de escribir código.
La migración de la versión v1 (legacy) a la v2 (app nativa) fue otra prueba: refactor profundo, mover datos de un Firestore a otro, mantener compatibilidad con clientes antiguos durante la transición. Una sola sesión de Claude Code, varios días seguidos, cero downtime.
Resultados
ShopiUP v2 está publicada en el Shopify App Store, aprobada por el equipo de revisión de Shopify, e instalable por cualquier merchant. La arquitectura serverless en Cloud Run escala automáticamente sin tener que aprovisionar servidores. Los costos operativos son mínimos: el comerciante paga por uso, los recursos GCP escalan a cero cuando no hay actividad.
El producto es nuestro laboratorio para todo lo relacionado con apps embebidas, OAuth de plataformas grandes y operaciones bulk sobre catálogos. Patrones que validamos aquí los reutilizamos cuando construimos integraciones Shopify a la medida para clientes (como el middleware para Hyundai Electronics — otro caso que publicamos en esta serie).
¿Qué replicamos a clientes?
Si vendes en Shopify y tu equipo de marketing se la pasa editando descripciones de producto a mano, ShopiUP es para ti — la instalas, autorizas y empiezas. Si necesitas algo más profundo (integraciones con CRM, ERP, sistemas de bodega, calculadora de fletes), construimos middleware nativo Shopify desde cero. Hablemos.