wc_get_products: listar productos
Enumera los productos del catálogo.
Argumentos
| Argumento | Valor predeterminado | Significado |
|---|---|---|
status |
publish |
Estado del producto |
page |
1 | Número de página |
per_page |
20 | Productos por página, limitado a 1–100 |
Permisos
mcp:read y woocommerce:catalog:read, además de manage_woocommerce o edit_products.
Qué devuelve
Solo items — sin total. Cada producto incluye id, type, name, slug, status, sku, price, regular_price, sale_price y permalink.
Los listados omiten la descripción, las categorías y los atributos; estos provienen de wc_get_product.
Como no hay total, usa wc_get_store_stats para dimensionar el catálogo antes de dar por completo un listado.
Lee los tres campos de precio en conjunto
Cada elemento incluye los tres, y leerlos en conjunto te indica el estado comercial real del producto:
regular_pricecon valor,sale_pricevacío — se aplica el precio normal.- ambos con valor — el producto está en oferta, y
priceequivale asale_price. pricedistinto deregular_price— algo lo está descontando.
Esta es la forma más rápida de auditar qué productos están actualmente en oferta, y conviene hacerlo antes de cualquier cambio masivo de precios. Un incremento porcentual aplicado a un catálogo donde un tercio de los productos están en oferta se comporta de forma distinta en esos productos.
type decide qué más se aplica
Los productos simple llevan su propio precio y existencias. Los productos variable delegan ambos en sus variaciones — el price de un producto variable se deriva de sus hijos, y escribir un precio en el padre no controla lo que pagan los clientes.
Comprueba type antes de planificar cualquier trabajo con precios. Consulta wc_get_product_variations.
Sin más filtros que el estado
No hay filtro por categoría, ni búsqueda, ni rango de precios, ni argumento de ordenación. El listado devuelve los productos en el orden predeterminado de WooCommerce para el estado que solicites.
Para trabajar con un conjunto específico — por ejemplo, los productos de una categoría — necesitarás sus ID desde el administrador de WooCommerce o desde una consulta del lado del contenido, y luego leerlos individualmente.
Esa es una limitación real para el trabajo masivo a través de MCP: reunir el conjunto objetivo suele ser más difícil que modificarlo.
Borradores y otros estados
El valor predeterminado es publish. Pasa status para ver borradores o productos privados — útil para comprobar trabajos en curso y un recordatorio de que una auditoría del catálogo con el valor predeterminado omite todo lo no publicado.
Cómo usarlo bien
Enumera los productos publicados con sus ID, SKU y los tres campos de precio, y detente.
Enumera los productos en borrador.
Antes de un trabajo con precios:
Enumera los productos e indícame cuáles tienen actualmente un precio de oferta.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Las herramientas de WooCommerce faltan por completo | WooCommerce no está activo en este sitio |
pom_ai_mcp_wc_forbidden |
El usuario que actúa carece de manage_woocommerce y edit_products |
| Menos productos de los que tiene la tienda | per_page está limitado a 100 y no hay total |
| Faltan borradores | El estado predeterminado es publish |
| El precio de un producto variable parece incorrecto | Se deriva de las variaciones |