wc_get_store_stats: leer las estadísticas de la tienda

Recuentos agregados del catálogo. Deliberadamente acotado: solo catálogo, sin datos de ventas.

Argumentos

Ninguno.

Permisos

mcp:read y woocommerce:catalog:read, más manage_woocommerce o edit_products.

Qué devuelve

Campo Significado
products Recuentos de productos por estado de la entrada
coupons Recuentos de cupones por estado de la entrada
attributes Cuántos atributos globales existen

Las cifras de productos y cupones se desglosan por estado: publicado, borrador, privado, papelera y cualquier otro estado registrado.

Sin datos de ventas, deliberadamente

La propia descripción de la herramienta dice solo estadísticas de catálogo, y ese es el límite: sin pedidos, sin ingresos, sin clientes, sin reembolsos, sin valoración de existencias.

Todo eso vive en otra parte de WooCommerce y no está expuesto por ninguna herramienta MCP. Un asistente al que se le pregunte «¿cómo van las ventas este mes?» no puede responder, y no debe aparentar que sí. Consulta Qué no expone POM AI MCP.

Es el total que faltaba para los listados de productos

wc_get_products no devuelve ningún total y limita a 100 por página. Esta herramienta es la forma de saber si un listado estaba completo.

Obtén las estadísticas de la tienda, luego lista los primeros 100 productos y dime si son todos.

Sin ella, un asistente que lista una sola vez razonará sobre cien productos como si fueran el catálogo — y una regla de precio al por mayor basada en esa suposición omitirá silenciosamente el resto.

El desglose por estado es la parte útil

  • Un recuento alto de draft significa productos sin terminar que una instrucción amplia podría tocar.
  • Un recuento alto de trash significa eliminaciones aún no purgadas, y productos que todavía ocupan SKUs.
  • publish muy por debajo del total significa que la mayor parte del catálogo no está en vivo.

Antes de aceptar nada que afecte a todo el catálogo, conoce estas cifras.

El recuento de attributes fija las expectativas

Una tienda con muchos atributos globales es una en la que los productos variables son la norma, y el trabajo de precios se hará mayormente sobre variaciones en lugar de productos.

Un recuento de cero significa que no existen atributos globales, de modo que cualquier producto variable usa en su lugar atributos personalizados propios del producto. Consulta wc_get_product_attributes.

Los recuentos de cupones también pertenecen aquí

Los cupones los cuenta esta herramienta aunque sus propias herramientas viven en Herramientas de cupones. Vale la pena notar un recuento alto en papelera antes de que nadie use wc_empty_coupon_trash.

Cómo usarla bien

Al inicio de cualquier sesión de tienda:

Obtén las estadísticas de la tienda y muéstrame los desgloses de productos y cupones.

Esa única llamada te dice la forma de la tienda, si los listados estarán completos y si hay una acumulación de borradores o de papelera — antes de que aceptes cambiar nada.

Problemas comunes

Síntoma Causa
La herramienta no aparece WooCommerce no está activo
pom_ai_mcp_wc_forbidden Falta la capacidad de tienda
Recuentos más altos de lo que la tienda parece tener Se incluyen papelera y borradores
Sin cifras de ventas Correcto; solo catálogo
attributes es 0 No hay atributos globales definidos