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:

  1. Esta herramienta — qué atributos existen.
  2. wc_get_attribute_terms — qué valores ofrece cada uno.
  3. wc_set_product_attributes — adjuntarlos al producto.
  4. 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