Referencia de herramientas de producto de WooCommerce
Quince herramientas para productos, variaciones y atributos. Todo lo que hay aquí está activo comercialmente: un precio escrito mediante estas herramientas aparece en la tienda de inmediato.
Productos
| Herramienta | Hace | Escribe |
|---|---|---|
wc_get_products |
Listar productos | |
wc_get_product |
Leer un producto | |
wc_create_product |
Crear un producto | Sí |
wc_update_product |
Actualizar un producto | Sí |
wc_get_store_stats |
Recuentos del catálogo |
Variaciones
| Herramienta | Hace | Escribe |
|---|---|---|
wc_get_product_variations |
Listar las variaciones de un producto | |
wc_get_variation |
Leer una variación | |
wc_create_variation |
Crear una variación | Sí |
wc_update_variation |
Actualizar una variación | Sí |
wc_delete_variation |
Eliminar una variación | Sí |
wc_batch_update_variations |
Actualizar varias a la vez | Sí |
Atributos
| Herramienta | Hace | Escribe |
|---|---|---|
wc_get_product_attributes |
Listar atributos globales | |
wc_get_attribute_terms |
Listar los términos de un atributo | |
wc_create_product_attribute |
Crear un atributo global | Sí |
wc_set_product_attributes |
Establecer los atributos de un producto | Sí |
Requisitos
WooCommerce debe estar activo, o ninguna de estas herramientas se registra: un cliente que pida una obtiene pom_ai_mcp_unknown_tool.
Permisos
| Requiere | |
|---|---|
| Ámbitos, lecturas | mcp:read, woocommerce:catalog:read |
| Ámbitos, escrituras | mcp:write, woocommerce:catalog:write |
| Capacidad | manage_woocommerce o edit_products |
| Puerta de escritura | Allow WooCommerce catalog writes |
La comprobación de capacidad acepta cualquiera de las dos capacidades, de modo que tanto un gestor de tienda como un usuario con derechos de edición de productos cumplen los requisitos.
Ten en cuenta que leer también requiere una capacidad. A diferencia de las entradas publicadas, que cualquier persona autenticada puede leer, los datos de producto quedan detrás del permiso de la tienda aunque la mayoría sean públicos en la tienda.
No existe una herramienta de eliminación de productos
Es deliberado, y conviene saberlo antes de planear una limpieza del catálogo. Los productos se pueden crear y actualizar mediante MCP, pero eliminar uno es tarea del administrador de WooCommerce.
Las variaciones sí se pueden eliminar. También los cupones; consulta Herramientas de cupones.
Campos que suenan parecidos y no lo son
La fuente más habitual de errores costosos en este capítulo:
| Campo | Es |
|---|---|
regular_price |
El precio normal |
sale_price |
El precio con descuento, cuando está en oferta |
price |
Solo lectura. El precio efectivo que WooCommerce calculó |
Escribir regular_price en un producto que está en oferta no cambia nada de lo que ve un cliente, porque el precio de oferta sigue aplicándose. Escribir sale_price cuando querías decir el precio normal inicia una oferta.
price aparece en todas las respuestas y no se puede escribir. Úsalo para comprobar el resultado, no para fijarlo.
Los mismos tres existen en las variaciones.
El stock tiene dos partes independientes
manage_stock activa o desactiva el seguimiento de stock; stock_quantity fija el número. Fijar una cantidad mientras la gestión de stock está desactivada almacena un número que nada utiliza.
Lee el estado actual antes de cambiar cualquiera de los dos.
Simulaciones
Toda herramienta de escritura admite dry_run. Las dos herramientas de actualización devuelven un before y un after auténticos; crear y eliminar informan de lo que harían.
Para cualquier cosa que afecte al precio o al stock, úsalo siempre. Es la comprobación más barata posible contra una confusión de campos.