Gestionar productos de WooCommerce
Los cambios en el catálogo son las escrituras de mayor riesgo que ofrece MCP. Un precio es público en el momento en que se guarda, y uno incorrecto es un problema comercial más que cosmético.
Requisitos
- WooCommerce activo, o las herramientas no se registran.
- Allow WooCommerce catalog writes abierto; su propia puerta de control.
woocommerce:catalog:readywoocommerce:catalog:write.- Un usuario con capacidad de gestión de la tienda.
- Un entorno de pruebas para cualquier operación masiva. Una copia de seguridad para cualquier cosa en absoluto.
Las herramientas
| Herramienta | Hace |
|---|---|
wc_get_products |
Listar productos |
wc_get_product |
Leer uno |
wc_create_product |
Crear un producto simple o variable |
wc_update_product |
Actualizar uno |
wc_get_store_stats |
Recuentos a nivel de tienda |
wc_get_product_attributes |
Listar atributos |
wc_get_attribute_terms |
Listar los términos de un atributo |
wc_create_product_attribute |
Crear un atributo |
wc_set_product_attributes |
Establecer los atributos de un producto |
No existe una herramienta de eliminación de productos. Es deliberado, y es un límite que conviene conocer: eliminar un producto es trabajo del panel de administración de WooCommerce.
Lee siempre el producto primero
Lee el producto 219 y muéstrame su nombre, precio, precio de oferta, estado de existencias y cantidad de existencias.
wc_get_product devuelve el estado actual. Para un cambio en el catálogo esto no es solo una buena práctica: es la forma de obtener los valores antiguos que necesitarás si el cambio resulta incorrecto.
Consérvalos. No hay deshacer, y las revisiones de WooCommerce no cubren los metadatos del producto del mismo modo que las revisiones de entradas cubren el contenido.
Usa la ejecución de prueba
Tanto wc_create_product como wc_update_product admiten dry_run, y la actualización devuelve una comparación real de antes y después:
Usa una ejecución de prueba para establecer el precio en 24,90 y muéstrame el antes y el después.
Para los precios, hazlo siempre. Leer la comparación lleva segundos y detecta la diferencia entre cambiar el precio normal y cambiar el precio de oferta, que es fácil de confundir y caro de equivocar.
Acota el cambio con precisión
Actualiza solo el precio normal del producto 219. No cambies el precio de oferta, las existencias, la descripción, las categorías ni el estado.
El precio, el precio de oferta, la cantidad de existencias y el estado de existencias son cuatro campos separados que todos suenan como «el precio y la disponibilidad». Nombra el que te refieres y excluye el resto.
Crear productos
wc_create_product crea un producto simple o variable. Para un producto variable, las variaciones son un trabajo aparte; consulta Gestionar variaciones de producto.
Crea como borrador siempre que puedas, revísalo en el panel de administración de WooCommerce y publícalo deliberadamente. Un producto creado directamente como publicado está activo antes de que nadie lo haya visto.
Atributos antes que variaciones
Para un producto variable el orden importa:
wc_get_product_attributes: mira lo que existe globalmente.wc_create_product_attributesi se necesita un atributo genuinamente nuevo.wc_set_product_attributes: adjúntalos al producto.- Después crea las variaciones.
Los atributos creados sin cuidado se acumulan: «Colour», «Color» y «colour» como tres atributos globales es un desorden que aparece en los filtros y en la búsqueda facetada. Lee primero los existentes y sé explícito sobre si se permite crear otros nuevos.
Cambios masivos
Cuenta primero con wc_get_store_stats o con un listado filtrado; después, haz una prueba piloto:
Lista los productos de la categoría «Outdoor» con sus ID y precios actuales, y luego detente.
Aplica el cambio solo a los tres primeros y muéstrame el antes y el después de cada uno.
Las escrituras están limitadas a 20 por minuto, por lo que un trabajo sobre todo el catálogo se va dosificando igualmente. Usa esa dosificación para verificar.
Para una subida de precio en toda una gama, la prueba piloto es lo que te indica si el asistente está aplicando la regla que querías: un aumento del 5 % sobre el precio normal no es lo mismo que sobre el precio efectivo actual cuando existe un precio de oferta.
Después de cualquier cambio en el catálogo
- Vuelve a leer el producto.
- Abre la página del producto en la tienda.
- Comprueba el precio mostrado, incluido si se muestra un precio de oferta.
- Comprueba las páginas de listado de categoría y de tienda, que almacenan en caché de forma agresiva.
- Purga la caché. Consulta Borrar la caché de POM.
- Purga la CDN si tienes una.
Los precios son exactamente el tipo de cosa que una caché de página guarda y un cliente captura con una captura de pantalla.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Faltan las herramientas de WooCommerce | WooCommerce no está activo aquí |
| La escritura se rechaza | La puerta de escritura del catálogo está cerrada, o capacidad insuficiente |
pom_ai_mcp_wc_product_not_found |
ID incorrecto |
pom_ai_mcp_wc_forbidden |
El usuario que actúa no puede gestionar productos |
| Cambió el precio de oferta en lugar del precio | Los campos se confundieron; usa una ejecución de prueba |
| La tienda muestra el precio antiguo | La caché o la CDN no se purgaron |
| Aparecieron atributos duplicados | Se crearon atributos nuevos en lugar de reutilizarlos |