Plugins · Visión general

Neuroon ofrece dos rutas para conectar tu tienda al motor semántico:

1. Plugins oficiales para plataformas que ya tienen un ecosistema propio (WordPress).
2. Integración custom server-to-server cuando tu stack es propio o no encaja en un plugin (Next.js, Nuxt, monolito Java, etc.).

Esta página resume la matriz de capacidades y te orienta hacia la guía correcta.

Matriz de capacidades

Capacidad	WordPress · neuroon-search v0.8.4	Custom · script + server-to-server
Distribución	Plugin oficial (ZIP / wp.org pendiente)	Loader CDN + tu backend
Verificación de dominio	Automatizada (Settings tab)	Manual vía API
Sync de productos	Automática (hooks WooCommerce)	Tu cron / webhook
Cart bridge	Inline (WC events → neuroon:cart-update)	Dispatch manual
Tracking de conversiones	Server-side desde WC checkout (recomendado)	Server-side desde tu backend
Widget token	Firmado server-side y cacheado en options + transient	Tu cache (Redis, KV, memoria, etc.)
Estado	Mantenido por Neuroon	Self-managed

Shopify no está soportado como plugin en este momento. Los proyectos Shopify deben usar la ruta custom (loader CDN + emisión de tokens server-to-server desde una app privada o un backend intermedio).

Dos plugins WordPress, dos productos distintos

Hay dos plugins WordPress que comparten dominio pero atacan casos de uso diferentes:

Plugin	Versión	Para qué sirve
neuroon-search	0.8.4	Búsqueda semántica + sync de catálogo + widget embebible. Es la pieza que documentan estas guías.
neuroon-agentic-commerce	0.1.0	Universal Commerce Protocol (UCP) para que agentes de IA (Google Search AI Mode, Gemini, ChatGPT) descubran y compren en tu tienda. Producto separado, se documenta aparte.

Cuál elegir

• Tienes WooCommerce: usa plugins/wordpress/installation. Es la ruta más corta (sync automática, cart bridge incluido).
• Tu stack es propio (Next.js, Nuxt, Rails, Spring, etc.): arranca por plugins/custom/standalone y emite los tokens server-to-server siguiendo el recipe correspondiente.

Endpoints públicos comunes

Independientemente de la ruta, todas las integraciones hablan con el mismo conjunto reducido de endpoints:

POST/api/plugin/shops/{shopId}/products/sync

POST/api/plugin/shops/{shopId}/verify

POST/api/plugin/shops/{shopId}/track/conversion

El Widget Token lo firma tu propio servidor localmente con la Shop API Key como secreto HMAC — no es un endpoint. Ver Recipe · Server-to-server token.

Si tu plataforma no aparece arriba, el patrón server-to-server cubre cualquier stack: ver recipes/server-to-server-token.

Soporte y contribución

• Reporta issues en el tracker público o desde el dashboard.
• Para integraciones custom críticas, contacta al equipo (ver resources/support).