wc_get_product_attributes: listar atributos de producto
Enumera los atributos globales de la tienda — los que se definen una sola vez en Productos → Atributos y que son reutilizables en todos los productos.
Argumentos
Ninguno.
Permisos
mcp:read y woocommerce:catalog:read, además de manage_woocommerce o edit_products.
Qué devuelve
items, cada uno con:
| Campo | Significado |
|---|---|
id |
El ID del atributo, necesario para wc_get_attribute_terms |
name |
El slug interno |
label |
El nombre que se muestra en el panel de administración y, normalmente, en la tienda |
type |
Cómo se eligen los valores — normalmente select |
Tanto name como label se devuelven porque son distintos y se usan en lugares diferentes: label es lo que la gente reconoce, name es lo que usan los datos.
Solo atributos globales
WooCommerce tiene dos tipos:
- Globales — definidos para toda la tienda, con sus propias listas de términos. Estos aparecen aquí.
- Personalizados — escritos directamente en un único producto, con valores que existen solo en ese producto. Estos no aparecen aquí.
Así que una lista vacía no significa que la tienda no tenga productos variables. Significa que ninguno de ellos usa atributos globales. Para ver lo que un producto concreto declara realmente, lee el propio producto con wc_get_product, cuya respuesta completa incluye su attributes.
Confundir los dos es la causa habitual de variaciones que nunca llegan a ser seleccionables.
Es el primer paso de cualquier trabajo con variaciones
Los IDs que aparecen aquí desbloquean las listas de términos, y los términos son de lo que se construyen las variaciones. El orden es fijo:
- Esta herramienta — qué atributos existen.
wc_get_attribute_terms— qué valores ofrece cada uno.wc_set_product_attributes— adjuntarlos al producto.wc_create_variation— una por combinación.
Saltarte hasta el paso cuatro es como consigues variaciones que nadie puede comprar.
Sin recuentos de términos, sin productos
El listado dice qué atributos existen, no cuánto se usan. No te dice cuántos términos tiene un atributo ni qué productos lo usan.
Para los términos, llama a la siguiente herramienta. Para el uso, no hay ninguna herramienta MCP — compruébalo en el panel de administración.
Cómo usarlo bien
Enumera los atributos globales de la tienda con sus IDs y etiquetas.
Antes de crear uno:
Enumera los atributos y dime si ya existe algo parecido a «Material».
Esa comprobación importa: los atributos duplicados con etiquetas casi idénticas son complicados de deshacer después, y wc_create_product_attribute creará sin problema el segundo.
Problemas habituales
| Síntoma | Causa |
|---|---|
| Falta la herramienta | WooCommerce no está activo |
pom_ai_mcp_wc_forbidden |
Falta una capacidad de la tienda |
| Una lista vacía | No hay atributos globales; los productos pueden seguir usando atributos personalizados |
| Falta un atributo que esperabas | Es un atributo personalizado por producto |
name y label son distintos |
Es lo esperado; uno es el slug y el otro el nombre visible |
Relacionado
wc_get_attribute_terms— siguiente pasowc_create_product_attributewc_get_store_stats— incluye un recuento de atributos