API de productos WooCommerce para agentes de IA
Expón un catálogo WooCommerce compacto y de solo lectura para descubrimiento, búsqueda filtrada y verificación de productos, sin publicar credenciales REST administrativas.
La respuesta directa
KaliCart Bridge publica una capa pública de lectura de productos en el dominio del comercio. Un agente compatible descubre la interfaz, busca resúmenes paginados y verifica el detalle actual de un producto seleccionado. Las operaciones de escritura quedan excluidas.
¿Por qué no entregar la API REST de WooCommerce?
La API REST es amplia y suele usar credenciales. Un agente público necesita un contrato menor: descubrir, buscar de forma eficiente, verificar una oferta y seguir la URL de compra canónica.
Flujo de solicitudes
1. Descubrir capacidades
Leer puntos de entrada e indicaciones públicas.
2. Buscar registros compactos
Texto, categoría y paginación reducen los candidatos.
3. Verificar un candidato
Identidad, precio, stock y variantes se comprueban en WooCommerce.
4. Respetar las señales
Errores, máximos y Retry-After guían la corrección o la espera.
5. Volver a la tienda canónica
Opciones, envío, impuestos y pago permanecen con el comercio.
Datos para decisiones de producto
| Señal | Utilidad |
|---|---|
| Identidad estable | ID, SKU y URL canónica distinguen candidatos. |
| Clasificación | Nombres, categorías, marcas y atributos permiten buscar y comparar. |
| Oferta | Precio, moneda y stock reflejan la publicación actual de WooCommerce. |
| Variantes | La respuesta indica cuándo falta una selección exacta. |
| Límite de acción | Estado de compra y enlaces muestran cuándo debe intervenir el comercio. |
Acceso acotado al catálogo
- Solo lectura, sin endpoints de clientes, pedidos o administración.
- Paginación y tamaños máximos evitan solicitar todo el catálogo.
- Los resúmenes reducen tokens, ancho de banda y trabajo del servidor.
- Las señales de límite permiten esperar y reintentar.
- WooCommerce sigue siendo la fuente actual autorizada.
API, feed y MCP son capas distintas
| Superficie | Uso adecuado |
|---|---|
| Feed de productos | Envío masivo según el formato de una plataforma. |
| API de catálogo Bridge | Descubrimiento en vivo y verificación selectiva. |
| Servidor MCP | Descubrimiento e invocación de herramientas por clientes MCP. |
| Checkout WooCommerce | Opciones, envío, impuestos, pago y transacción. |
Soluciones relacionadas
Comercio agéntico para WooCommerce
Ubica la API en el recorrido hasta el checkout controlado.
Feed de plataformaFeed de productos ChatGPT para WooCommerce
Usa el feed separado para los envíos masivos.
Preguntas frecuentes
- ¿La API requiere claves consumer de WooCommerce?
- No para las rutas públicas de lectura de Bridge. Exponen datos comerciales públicos y acotados sin autoridad administrativa.
- ¿Un agente puede actualizar productos o crear pedidos?
- No. La interfaz de catálogo Bridge es de solo lectura. La administración y los pedidos quedan fuera del contrato público.
- ¿Un agente puede descargar todo el catálogo en una solicitud?
- No. Las búsquedas y listas están paginadas y limitadas. Primero se reducen los candidatos y después se solicita el detalle.
- ¿Es lo mismo que un feed de productos?
- No. Un feed sirve para envíos masivos; la API permite solicitudes selectivas y actuales en el dominio del comercio.
- ¿Es un servidor MCP?
- No. Es la interfaz comercial de solo lectura para agentes e integraciones. KaliCart ofrece una superficie MCP separada.
- ¿Qué ocurre al alcanzar el límite?
- La tienda puede devolver una respuesta de límite con indicaciones de reintento. Un agente conforme espera el intervalo indicado.