wc_get_product: obtener un producto
Lee un solo producto completo. La llamada que debe preceder a toda escritura en el catálogo.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
id |
Sí | El ID del producto |
Permisos
mcp:read y woocommerce:catalog:read, además de manage_woocommerce o edit_products.
Qué devuelve
Todo lo que devuelve un listado — id, type, name, slug, status, sku, price, regular_price, sale_price, permalink — además de description, short_description, categories y attributes.
Por qué importa más aquí que en otros sitios
No hay manera de deshacer un precio. WooCommerce guarda revisiones del contenido de la entrada de un producto, pero no de su precio, su stock ni su SKU.
Así que los valores de esta respuesta son tu plan de recuperación. Pídelos antes de cada escritura y mantenlos en la conversación:
Muéstrame el precio normal actual, el precio de oferta, el stock y el SKU del producto 219. Luego cambia el precio normal a 24,90.
Consulta Recuperarse de una escritura fallida.
Leer price frente a regular_price
price es de solo lectura y refleja lo que un cliente paga realmente. Comparar ambos responde a la pregunta que importa antes de un cambio de precio:
- Coinciden — no hay ningún descuento activo; cambiar
regular_pricecambia lo que pagan los clientes. - Difieren — hay un precio de oferta en vigor, y cambiar solo
regular_priceno cambiará el precio visible para el cliente.
Esa comparación lleva un segundo y evita el error de catálogo más común que existe.
Comprueba type antes de hacer nada
Un producto variable no tiene un precio propio con sentido; su rango de precios se deriva de sus variaciones. Escribir precios en el producto padre no es un error, pero tampoco es efectivo.
Para un producto variable, el trabajo ocurre en wc_get_product_variations y en las herramientas de escritura de variaciones.
attributes muestra la configuración del producto
Para un producto variable, es sobre esto sobre lo que se construyen sus variaciones. Leerlo antes de crear variaciones es lo que evita variaciones que nunca coincidan con la selección de un cliente.
Para un producto simple, los atributos son especificaciones meramente informativas.
Consulta wc_set_product_attributes.
Las descripciones son HTML
description y short_description se almacenan como HTML y se devuelven tal como se almacenaron. Las escrituras sobre ellos se filtran como contenido de entrada, por lo que se permite el marcado y no se permiten los scripts.
Si un asistente está reescribiendo el texto de un producto, todo lo de Revisar el texto generado antes de publicar es aplicable — y las afirmaciones sobre productos conllevan más riesgo que la mayoría de textos.
Vuélvelo a leer después de escribir
Las herramientas de escritura devuelven el producto guardado, pero leer de forma independiente también detecta otro plugin que actúe al guardar — los plugins de precios dinámicos, conversión de moneda y catálogo enganchan todos el guardado de productos.
Aplica el cambio y luego vuelve a leer el producto 219 y muéstrame los tres campos de precio.
Cómo usarlo bien
Lee el producto 219 y muéstrame todos los campos.
Muéstrame el stock y los precios actuales del producto 219 antes de cambiar nada.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_wc_product_not_found |
ID incorrecto, o el ID no es un producto |
pom_ai_mcp_wc_forbidden |
Falta capacidad de tienda |
price difiere de regular_price |
Hay un precio de oferta o un plugin de precios activo |
| Un producto variable muestra un precio extraño | Se deriva de sus variaciones |
| La descripción contiene marcado | Correcto; es HTML |
Relacionado
Permisos de objetos
El acceso al catálogo por sí solo no autoriza todos los objetos. Las actualizaciones y las lecturas privadas comprueban el objeto seleccionado; las operaciones sobre variaciones también comprueban su producto padre. La eliminación requiere capacidades de eliminación. Crear un cupón requiere capacidades de creación y publicación de cupones; crear un atributo global requiere manage_product_terms. Toda escritura utiliza el flujo de trabajo de aprobación.