Bienvenido a Neuroon

Neuroon es un motor de búsqueda semántica con IA para e-commerce. Sustituye la búsqueda léxica tradicional (LIKE, full-text) por embeddings vectoriales, ranking aprendido y un asistente conversacional que entiende intención, no sólo palabras clave.

Esta documentación describe lo que existe hoy en producción. No es un roadmap y no incluye funcionalidades planificadas como si estuvieran disponibles. Si una capacidad no aparece aquí, asume que aún no está implementada y consulta Qué no está soportado.

Para quién es Neuroon

• Tiendas con catálogo de al menos varios cientos de productos donde la búsqueda léxica ya falla (sinónimos, descripciones largas, atributos heterogéneos).
• Equipos que pueden sincronizar el catálogo vía API (server-to-server) y embeber un widget en el front.
• Stacks heterogéneos: WordPress/WooCommerce, .NET / DNN, tiendas custom en Node, PHP, Python, Java o Ruby.

Las tres piezas

Neuroon se compone de tres piezas que se integran de forma independiente:

• Widget — componente embebido vía <script> desde cdn.neuroon.ai. No hay paquete npm oficial. Búsqueda, voz, imagen, sugerencias y cross-sell.
• API Widget (/api/widget/*) — la consume el navegador, autenticada con X-Widget-Token.
• API Plugin (/api/plugin/shops/*) — la consume tu servidor para sincronizar productos, verificar dominio y registrar conversiones. Autenticada con X-Shop-API-Key.

El diagrama interactivo del flujo completo está en Arquitectura.

Cómo se integra Neuroon en tu tienda

Una integración mínima viable consta de:

1. Provisión de una tienda en Neuroon (Dashboard) y emisión de una Shop API Key (sk_<32hex>) y un Widget Token.
2. Sincronización del catálogo vía POST /api/plugin/shops/{shopId}/products/sync. Lotes de hasta 500 productos por request.
3. Embebido del widget mediante una etiqueta <script> con atributos data-* (data-token, data-container, data-locale, data-api-url).
4. Tracking de clics y conversiones para cerrar el bucle de aprendizaje.

Continuar

• Quickstart — integración mínima en 5 pasos, 5–10 minutos.
• Arquitectura — flujo de datos, eventual consistency, doble autenticación.
• Qué no está soportado — lista honesta de lo que no existe.