WooCommerce para agentes de compra con IA
Ofrezca a los agentes compatibles una ruta predecible y de solo lectura desde el descubrimiento hasta la URL de compra verificada de WooCommerce.
El problema
Una página de tienda explica productos a las personas. Las API generales de WooCommerce exponen datos al software. Un agente de compra necesita además un contrato público y predecible: cómo descubrir la tienda, buscar con eficiencia, verificar un solo producto elegido y respetar los límites del comerciante.
La respuesta directa
KaliCart Bridge publica una interfaz de catálogo de solo lectura desde el dominio del comerciante. Convierte los datos actuales de WooCommerce en resultados compactos, fichas detalladas e indicaciones explícitas para la siguiente solicitud. La tienda sigue siendo la fuente autorizada para precio, disponibilidad y checkout.
Un flujo disciplinado para el agente
1. Descubrir
Leer capacidades públicas y puntos de entrada del catálogo sin adivinar rutas.
2. Buscar resúmenes
Encontrar y ordenar candidatos con resultados compactos sin descargar cada producto completo.
3. Verificar la selección
Obtener detalles solo del producto elegido cuando se necesiten variantes, imágenes o preparación de compra.
4. Pasar al checkout
Enviar al comprador a la ruta autorizada de WooCommerce. Bridge no sustituye el checkout del comerciante.
Qué puede leer el agente
| Superficie | Señal estructurada |
|---|---|
| Descubrimiento | Puntos de entrada públicos y capacidades compatibles del catálogo. |
| Búsqueda | Consulta, filtros de categoría, paginación y resúmenes compactos. |
| Datos de producto | ID estable, SKU, marca, categoría, precio actual, disponibilidad y URL canónica. |
| Variantes | Si se requiere selección y detalles de variantes publicados por WooCommerce. |
| Guía de solicitud | Cuándo basta el resumen y cuándo verificar un único producto seleccionado. |
| Control de carga | Señales de límite, errores estructurados y Retry-After cuando la tienda pide reducir el ritmo. |
Límites que protegen al comerciante
Bridge expone una superficie comercial de lectura, no acceso ilimitado ni autoridad de compra.
- Un agente compatible debe decidir usar la interfaz; instalarla no obliga a todos los asistentes a descubrir la tienda.
- Solo se exponen datos públicos del catálogo. La información administrativa y privada queda fuera del contrato.
- Los límites protegen el alojamiento. Un agente disciplinado sigue las señales y reintenta cuando se le indica.
- Bridge ayuda al descubrimiento y la verificación; WooCommerce y el comerciante siguen autorizando precio, stock, condiciones y checkout.
Solución relacionada
Catálogo WooCommerce preparado para IA
Compruebe si los datos de producto tras la interfaz para agentes son suficientemente completos y fiables.
Preguntas frecuentes
- ¿Todos los agentes de IA descubrirán automáticamente mi tienda?
- No. Bridge publica una interfaz documentada, pero cada agente o plataforma decide qué fuentes y herramientas utiliza.
- ¿Esto sustituye la API REST de WooCommerce?
- No. Es un contrato comercial complementario, público y de solo lectura para un descubrimiento y una verificación eficientes.
- ¿Qué ocurre si un agente envía demasiadas solicitudes?
- Bridge puede devolver señales de límite y Retry-After. Un agente compatible reduce el ritmo y reintenta después del intervalo indicado.
- ¿Puede un agente cambiar precios, stock o pedidos mediante Bridge?
- No. La interfaz de catálogo es de solo lectura. WooCommerce y el comerciante siguen siendo responsables de los datos y las transacciones.
- ¿Bridge gestiona el checkout?
- No. Devuelve la URL de compra canónica del comerciante y mantiene el checkout en la tienda WooCommerce existente.
- ¿Tiene algún coste?
- Bridge es gratuito y de código abierto bajo licencia GPL, sin suscripción ni porcentaje de ventas.
