Un buscador que se integra sin rehacer tu tienda
AgentSearch se carga con un script que vive en su propio Shadow DOM: el CSS de tu tema no lo rompe y él no rompe tu tema. Por detrás, un servicio mantiene el índice al día leyendo tu tienda, tu PIM o tu ERP.
Qué hay que tocar en tu tienda y qué no
En la plantilla, poco. Casi todo el trabajo está en conectar bien los datos.
Widget ligero y aislado
Un script de unos 73 KB minificado (23 KB con gzip), en TypeScript sin frameworks y multiidioma. Se pinta en su propio Shadow DOM: los estilos de tu tema no le afectan y los suyos no se escapan.
- Carga con defer, sin bloquear el pintado de la página
- Se engancha a la caja de búsqueda que ya tiene tu tema
- Color de marca configurable por tienda
Sincronización del catálogo
El índice se construye desde donde estén los datos buenos. Un proceso incremental revisa cada 5 minutos los productos modificados, publicar un producto dispara su reindexado y el stock se lee de la tienda cada hora. Reindexar 77.000 productos sin recalcular vectores lleva 68 segundos.
- Actualizaciones parciales que conservan los vectores
- Aviso por correo si la sincronización falla
Carrito y ventas atribuidas
Cada resultado lleva su botón de añadir al carrito con el carrito nativo de la plataforma, y el contador del tema se actualiza sin recargar. Para saber qué pedidos vienen del buscador, en Shopify guardamos la búsqueda en el carrito y en PrestaShop cruzamos los pedidos en la base de datos.
- Shopify: atributos del carrito y webhook de pedidos firmado con HMAC
- PrestaShop: el mismo controlador de carrito que usa la tienda
Panel y API
Tu equipo gestiona sinónimos, curaciones y productos sustituidos desde un panel, y los cambios se aplican en la siguiente búsqueda. Para una app, un panel interno o un agente de IA, la misma búsqueda está disponible por API REST.
- Sinónimos globales y curaciones por tienda
- Búsqueda, autocompletado y seguimiento de clics por API
- Productos similares por texto o por imagen
Shopify, PrestaShop, WooCommerce o un ERP: qué cambia en cada caso
El widget es el mismo en todas. Lo que cambia es de dónde se lee el catálogo, cómo se añade al carrito y cómo se atribuye la venta.
| Plataforma | Catálogo y stock | Carrito | Dónde va el widget | Estado |
|---|---|---|---|---|
| Shopify | API de la tienda o PIM; stock cada hora y descontado con cada pedido | Carrito nativo de Shopify, con refresco del contador del tema | Fragmento antes de </body> en theme.liquid | En producción en varias tiendas |
| PrestaShop 1.7 | MariaDB con usuario de solo lectura; precio con el IVA de cada producto | Controlador de carrito nativo con el token de la tienda | Plantilla footer.tpl del tema | Implantado y validado en staging |
| WooCommerce | API REST de WooCommerce o lectura de la base de datos de WordPress | Añadir al carrito nativo de WooCommerce | Pie de página del tema hijo o un plugin mínimo | Sin tienda en producción todavía |
| A medida o ERP | Base de datos del ERP en solo lectura, por lotes y con límite de velocidad | El de tu tienda o tu app, por API | Script en la web o llamadas a la API | En uso sobre un ERP |
Lo que conviene saber, aprendido en producción
En Shopify no todos los temas se comportan igual. Con un tema basado en Warehouse el widget funcionó sin adaptadores, porque ya escucha el evento de refresco del carrito. Con Horizon hubo que ocultar su buscador modal y puentear el carrito.
En PrestaShop leemos la base de datos de la tienda con un usuario que solo puede leer, por lotes y con pausas para no cargar el servidor. El catálogo se copia al índice, así que cuando un cliente busca, la tienda no recibe ninguna consulta.
Cuando el catálogo vive en un ERP sin API, leemos su base de datos en solo lectura y decidimos qué merece estar en el buscador. En un ERP con unos 5 millones de artículos el índice se quedó en 99.013: activos, con precio y descripción, y con ventas, stock o alta en los últimos tres años.
WooCommerce todavía no lo tenemos en producción. El planteamiento sería el de PrestaShop: indexar desde la API REST o la base de datos, cargar el widget desde el pie de página y usar el carrito nativo.
Un buscador caído es una tienda sin buscador. El servicio vigila el disco del servidor, hace copia diaria del índice y, si la IA no responde, sigue sirviendo resultados sin ella. Y si algo no convence en el tema, volver atrás es quitar el fragmento de la plantilla.
De cero a buscador en producción
Te lo dejamos instalado, con copia del tema previo y con tu equipo sabiendo usar el panel.
Conectamos los datos
Tienda, PIM o ERP, en solo lectura
Configuramos el widget
Idioma, color y caja de búsqueda del tema
Lo instalamos en el tema
Con copia previa del tema
Formamos a tu equipo
Sinónimos, curaciones y lectura de la analítica
Dudas habituales sobre la integración
¿Cómo se instala AgentSearch en Shopify?
Con un fragmento antes de </body> en theme.liquid: un bloque con la configuración de la tienda y el script del widget cargado con defer. Lo hacemos nosotros por la API de la tienda o desde el editor de código. El widget se engancha a la caja de búsqueda que ya tiene el tema, y para medir ventas se añade un webhook de pedidos.
¿Funciona en PrestaShop?
Sí. Lo hemos implantado sobre PrestaShop 1.7 leyendo su base de datos en solo lectura, con el IVA de cada producto, el carrito nativo de la tienda y el widget cargado desde footer.tpl. Las ventas se atribuyen cruzando los pedidos de la base de datos.
¿Y en WooCommerce?
Técnicamente sí, con el mismo enfoque que en PrestaShop, pero todavía no tenemos ninguna tienda WooCommerce en producción con AgentSearch. Preferimos decirlo claro: si tu tienda es WooCommerce, lo valoramos con tu catálogo antes de comprometer un plazo.
¿El widget ralentiza la tienda?
Son unos 73 KB minificados (23 KB si se sirve comprimido), se carga con defer y no depende de React ni de otras librerías, así que no bloquea el pintado de la página. El trabajo pesado (índice, filtros e IA) ocurre en el servidor. Lo que sí conviene revisar es que no queden cargados scripts de buscadores anteriores.
¿Puedo usar la búsqueda sin el widget, desde mi app o un agente de IA?
Sí. El servicio ofrece búsqueda, autocompletado y seguimiento de clics por API REST, con los mismos sinónimos y curaciones que el widget. En una implantación, el chat de IA de la tienda usa esa búsqueda como herramienta para consultar productos, stock y compatibilidades.
Te enseñamos cómo quedaría en tu tema
Dinos qué plataforma y qué tema usas, y de dónde sale tu catálogo. Con eso te decimos qué hay que tocar y qué no.