Cómo los agentes de IA leen y actúan sobre los datos de tu WooCommerce Wishlist

Muchos propietarios de tiendas WooCommerce han oído hablar de la IA como un widget de chat en la esquina de una página de producto. Así que, cuando un cliente pregunta qué puede hacer la IA con los datos de la tienda, la respuesta honesta generalmente ha sido "no mucho".

Eso está cambiando. WordPress 6.9 añadió la API de Capacidades al núcleo. Es un estándar que permite a un plugin publicar acciones nombradas que otro software puede descubrir y llamar. SaveTo Wishlist Pro registra 15 de ellas, comenzando con el lanzamiento que introdujo el soporte para la API de Capacidades.

Esta guía cubre el acceso a los datos de la lista de deseos del agente de WooCommerce desde el lado del propietario de la tienda, no desde el del desarrollador. Verás qué es una habilidad, qué datos de la lista de deseos puede leer un agente y qué puede cambiar. También cubriré el modelo de permisos, cómo conectar un cliente y dónde se detiene todo.

Saltar a:

---

Qué es realmente la API de Capacidades de WordPress

La API de Habilidades de WordPress es una forma estándar para que un plugin publique las cosas con nombre que puede hacer. El software fuera de WordPress puede entonces encontrar esas acciones y ejecutarlas sin una integración personalizada.

Piénsalo como un menú de restaurante. Sin él, cada comensal tendría que entrar en la cocina y explicar lo que quería. Un menú enumera los platos y lo que viene con cada uno, y deja que la cocina se encargue de quién recibe el servicio. Las habilidades hacen ese trabajo para tu sitio.

Dónde encaja MCP

Cada habilidad tiene un nombre, una entrada definida, una salida definida y una verificación de permisos. Esa estructura es importante debido a un segundo estándar, el Protocolo de Contexto de Modelo, generalmente abreviado como MCP. MCP es un formato compartido que los clientes de IA utilizan para encontrar herramientas disponibles y llamarlas.

Sin embargo, WordPress no habla MCP por sí solo. Un plugin puente como el Adaptador MCP oficial convierte las habilidades en herramientas que un cliente MCP puede listar. Nuestro plugin hermano StoreAgent también ejecuta un servidor MCP, con configuración para explorar las habilidades que registran tus plugins.

La secuencia es la siguiente:

1. El plugin registra sus habilidades. Esto ocurre en tu sitio, en el código, cuando el plugin se carga.
2. Un cliente se conecta a través del puente y pregunta qué está disponible. Recibe una lista estructurada de acciones con nombre, no un muro de documentación.
3. Haces una pregunta en lenguaje normal. Algo como “¿qué productos está guardando más la gente este mes?”
4. El cliente elige una habilidad coincidente y la llama. La respuesta proviene de los datos de tu tienda en vivo.

No hay exportación, ni hoja de cálculo, ni conector personalizado para cada herramienta de IA. Tu tienda publica el menú una vez, y cualquier cliente que hable MCP puede pedirlo una vez que lo conectes.

---

Cómo se ve una capacidad en la práctica

Una habilidad es una acción con nombre con una entrada fija, una salida fija y una verificación de permisos que se ejecuta primero. Es deliberadamente pequeña, por lo que una habilidad hace un trabajo de la misma manera cada vez.

SaveTo Wishlist Pro registra sus habilidades bajo el prefijo saveto-wishlist/, dentro de una categoría de habilidad llamada saveto-wishlist. Como resultado, cada nombre de habilidad te dice de qué plugin provino.

Otros plugins de Rymera utilizan la misma API. Advanced Coupons, por ejemplo, te permite gestionar cupones de WooCommerce con IA.

Toma get-product-insights. Es de solo lectura, por lo que llamarlo no cambia nada. Por ejemplo, pídele a un asistente qué productos guardan más los clientes, y te devolverá tus productos más populares, de tendencia y añadidos recientemente. Una consulta de seguimiento sobre categorías va a get-category-insights, que agrupa la actividad de la lista de deseos por categoría y marca.

Ahora toma share-wishlist-by-link. Escribe, por lo que se marca como destructivo. También se marca como idempotente, por lo que es seguro reintentarlo. En otras palabras, llamarlo dos veces con la misma entrada termina en el mismo estado.

Si estás escribiendo código contra la tienda tú mismo, la API REST sigue siendo la herramienta adecuada. La guía del desarrollador de la API REST de la lista de deseos cubre esos puntos finales. Dicho esto, los dos son fáciles de confundir. Los puntos finales REST son adecuados para el software que estás creando y controlando, mientras que las habilidades son adecuadas para el software que no creaste, como un cliente de IA.

---

El modelo de permisos y lo que un agente tiene permitido hacer

Cada habilidad ejecuta una devolución de llamada de permiso antes de hacer nada, y esa verificación es el núcleo de la historia de seguridad. En resumen, un cliente de IA que pregunta educadamente no amplía lo que un usuario tiene permitido hacer.

SaveTo Wishlist Pro utiliza dos devoluciones de llamada, pero establecen el mismo estándar:

• Habilidades destructivas: cualquier cosa que escriba o cambie datos se ejecuta detrás de una devolución de llamada can_manage_woocommerce. Ese es el territorio del administrador de la tienda, no del visitante general.
• Habilidades de solo lectura: estas utilizan una devolución de llamada separada can_view_data, pero verifica la misma capacidad manage_woocommerce. Leer necesita la misma cuenta que escribir.

Cada habilidad también lleva anotaciones MCP creadas a partir de sus indicadores destructivos e idempotentes. Esas anotaciones le dicen a un cliente, antes de que llame a algo, si una herramienta cambia datos y si un reintento es seguro.

Otra decisión de diseño importa más que todo lo anterior. Cada habilidad destructiva se entrega a la misma capa de servicio que utilizan las pantallas de administración, sin una ruta de código separada solo para IA. Por lo tanto, cuando un agente envía una lista de deseos por correo electrónico, se activan las mismas acciones de WordPress y WooCommerce que cuando lo haces tú. Se envían los mismos correos electrónicos y se ejecutan los mismos ganchos.

Eso puede sonar como una nota al pie arquitectónica seca. En la práctica, significa que un agente no tiene atajos para evitar tu registro, tus integraciones o tus notificaciones al cliente. Eso es lo que hace que la función sea algo que puedas auditar.

❗️🔍️ Qué comprobar: algunas herramientas añaden una ruta de código separada para el acceso automatizado. Los eventos que se activan con un clic humano pueden no activarse nunca con uno automatizado. Cuando eso sucede, un CRM puede dejar de recibir registros sin que nadie se dé cuenta. Sea lo que sea que conectes, pregunta si su ruta automatizada ejecuta el mismo código que sus pantallas de administración.

---

Lo que SaveTo Wishlist Pro expone a los agentes de IA

SaveTo Wishlist Pro registra una categoría de habilidad y 15 habilidades bajo el prefijo saveto-wishlist/. Llegaron en la versión Pro 1.0.2, lanzada el 30 de junio de 2026.

Esas habilidades informan sobre los datos que tus clientes crean cada día. Por ejemplo, un comprador hace clic en el botón de la lista de deseos, y ese clic se convierte en un registro que una habilidad de información puede contar más tarde. En el plugin gratuito SaveTo Wishlist Lite, el botón se muestra en las páginas de la tienda de inmediato. Una vez que un producto se guarda, su etiqueta cambia a “Eliminar de la lista de deseos”.

Cuatro habilidades para empezar

Aquí tienes cuatro que probablemente usarás primero:

Grupo de habilidades	Habilidad de ejemplo	¿Cambia datos?
Compartir	compartir-lista-deseos-por-enlace	Sí, se puede reintentar sin riesgo
Información del producto	obtener información del producto	No
Información de la categoría	obtener información de la categoría	No
Tendencias	obtener tendencias basadas en el tiempo	No

La lista completa de 15 sigue a esta sección. Cada una de estas cuatro responde a un tipo diferente de pregunta:

• Compartir: share-wishlist-by-link crea o actualiza un enlace para compartir una lista de deseos. Como es idempotente, un agente puede reintentarlo de forma segura después de una conexión interrumpida.
• Información del producto: get-product-insights responde a la pregunta de merchandising. ¿Qué artículos está guardando la gente y cuáles son tendencia?
• Información de la categoría: get-category-insights agrupa la actividad de la lista de deseos por categoría y marca, para que veas la demanda en un rango, no en un SKU.
• Tendencias: get-time-based-trends cubre las adiciones a lo largo del tiempo y los patrones de día de la semana. Esa es la diferencia entre saber que un producto es popular y saber cuándo la gente decide que lo quiere.

Además, Pro muestra esta información en sus pantallas de análisis de listas de deseos. Las habilidades son una ruta adicional a los mismos datos, no la única.

Qué plan necesitas

Aquí se indica qué hace cada producto. SaveTo Wishlist Lite es el plugin gratuito, y se mantiene gratuito. SaveTo Wishlist Pro es el plugin de pago que registra las habilidades, y está incluido en los tres planes de precios.

Growth cuesta 49,50 $ el primer año y se renueva a 99 $. Plus cuesta 99,50 $ el primer año y se renueva a 199 $. Business cuesta 199,50 $ el primer año y se renueva a 399 $. El Addon de Registro de Regalos viene solo con Plus y Business, no con Growth.

---

Las 15 capacidades y lo que cada una puede cambiar

Nueve de las 15 habilidades solo leen. Las otras seis cambian algo, y dos de ellas pueden enviar correo electrónico. Aquí está el conjunto completo:

Capacidad	Lo que hace	¿Cambia datos?
compartir-lista-deseos-por-enlace	Crea o actualiza un enlace para compartir una lista de deseos. No se envían correos electrónicos.	Sí, se puede reintentar sin riesgo
compartir-lista-deseos-por-correo	Envía una lista de deseos por correo electrónico a una lista de direcciones, con un mensaje opcional.	Sí
listar-listas-deseos-compartidas	Enumera las listas de deseos compartidas y sus destinatarios.	No
listar-automatizaciones	Enumera tus automatizaciones, filtradas por estado, desencadenante o acción si lo solicitas.	No
obtener-automatizacion	Devuelve la configuración completa de una automatización.	No
crear-automatizacion	Crea una nueva automatización a partir de un desencadenante y una acción.	Sí
actualizar-automatizacion	Edita una automatización existente.	Sí, se puede reintentar sin riesgo
conmutar-automatizacion	Activa o desactiva una automatización. Si no se proporciona estado, invierte el actual.	Sí, se puede reintentar sin riesgo
listar-clientes-lista-deseos	Enumera los clientes con listas de deseos activas, empezando por los más activos.	No
obtener-resumen-cliente-lista-deseos	Resume las listas de deseos, artículos, valor y última actividad de un cliente.	No
disparar-notificacion-manual	Ejecuta la acción de una automatización para un cliente, ahora mismo.	Sí
obtener información general	Cifras principales, incluida la tasa de conversión y la tendencia respecto al período anterior.	No
obtener información del producto	Productos más populares, en tendencia y añadidos recientemente.	No
obtener información de la categoría	Actividad de la lista de deseos agrupada por categoría y marca.	No
obtener tendencias basadas en el tiempo	Adiciones a lo largo del tiempo y patrones de días de la semana.	No

Detalles que cambian lo que debes preguntar

Algunos detalles en esa tabla dan forma a lo que debes preguntar a un agente:

• Las lecturas aún pueden devolver datos personales. list-wishlist-customers y get-customer-wishlist-summary devuelven nombres de clientes, correos electrónicos y gasto total. Las configuraciones de automatización pueden incluir encabezados de autenticación de webhook. Trata la cuenta conectada como cualquier inicio de sesión de personal.
• Las tendencias de productos miran hacia atrás 7 días a menos que pidas 30. get-product-insights solo acepta esos dos períodos. get-time-based-trends usa 30 días por defecto y también acepta 7, 90 o 365. Si pides algo más, usa silenciosamente el valor predeterminado.
• Algunas respuestas tienen un límite. Las estadísticas de productos devuelven los 10 productos más populares y los 10 en tendencia, además de 8 adiciones recientes. Las listas de clientes por defecto son 15 y las listas compartidas son 100. Ninguna supera los 200.
• trigger-manual-notification envía de verdad. Ejecuta la acción de una automatización existente para un cliente: un correo electrónico, una llamada webhook o una actualización de metadatos del usuario. Las automatizaciones basadas en productos se niegan a ejecutarse sin un ID de producto, por lo que los marcadores de posición sin rellenar nunca se envían.

---

Cómo conectar un cliente de IA a tu tienda

Registrar capacidades no conecta nada por sí solo. La conexión se realiza a través del plugin MCP Adapter, con un paso adicional que es fácil de pasar por alto.

El servidor predeterminado del adaptador solo enumera las capacidades marcadas como públicas, y SaveTo Wishlist Pro no marca sus capacidades de esa manera. Como resultado, un cliente apuntado al servidor predeterminado no las encontrará. En su lugar, registras un pequeño servidor propio, que también te permite elegir qué capacidades ofrece.

Configúralo paso a paso

Aquí tienes la configuración, de principio a fin:

1. Instala MCP Adapter. Es el plugin oficial y gratuito de WordPress para MCP, instalado desde su página de lanzamientos de GitHub. Necesita WordPress 6.9 o posterior.
2. Elige la cuenta que usará el agente. Cada capacidad verifica los permisos de manage_woocommerce, que WooCommerce otorga a los Administradores y Gerentes de Tienda. Un usuario dedicado de Gerente de Tienda mantiene la actividad del agente separada de tu propio inicio de sesión.
3. Crea una contraseña de aplicación para ese usuario. Ve a Usuarios, edita el usuario y desplázate hasta Contraseñas de aplicación. Escribe una etiqueta en Nombre de la nueva contraseña de aplicación y, a continuación, haz clic en Añadir contraseña de aplicación. Cópiala de inmediato, porque WordPress no la volverá a mostrar.
4. Registra un servidor que liste las capacidades que deseas. Añade el fragmento de código a continuación a un plugin específico del sitio o a un plugin de fragmentos de código.
5. Apunta tu cliente al servidor. La mayoría de los clientes de escritorio se conectan a través del proxy @automattic/mcp-wordpress-remote, que toma la URL de tu servidor, el nombre de usuario y la contraseña de la aplicación.

add_action( 'mcp_adapter_init', function ( $adapter ) {
    $adapter->create_server(
        'stw-agent',                  // Server ID
        'stw-agent',                  // REST namespace
        'mcp',                        // REST route
        'SaveTo Wishlist Agent',
        'Read-only SaveTo Wishlist abilities',
        '1.0.0',
        array( \WP\MCP\Transport\HttpTransport::class ),
        \WP\MCP\Infrastructure\ErrorHandling\ErrorLogMcpErrorHandler::class,
        null,
        array(
            'saveto-wishlist/get-overview-insights',
            'saveto-wishlist/get-product-insights',
            'saveto-wishlist/get-category-insights',
            'saveto-wishlist/get-time-based-trends',
            'saveto-wishlist/list-wishlist-customers',
            'saveto-wishlist/get-customer-wishlist-summary',
            'saveto-wishlist/list-shared-wishlists',
            'saveto-wishlist/list-automations',
            'saveto-wishlist/get-automation',
        )
    );
} );

Ese fragmento de código expone solo las nueve capacidades de solo lectura. Para permitir que el agente actúe, añade capacidades de escritura de la tabla anterior una a una. Con los IDs utilizados aquí, el endpoint es https://tutienda.com/wp-json/stw-agent/mcp.

Cómo cortar el acceso

Ten en cuenta que una contraseña de aplicación tiene los permisos completos de su usuario en toda la API REST, no solo estas capacidades. Al hacer clic en Revocar junto a ella en la misma pantalla, se desconecta al agente de inmediato.

Si ejecutas StoreAgent, tiene su propia guía para conectar Claude y ChatGPT a tu tienda.

Cómo saber que funcionó

Pide al cliente que liste sus herramientas. Cada capacidad aparece con su barra invertida cambiada por un guion, como saveto-wishlist-get-overview-insights. Luego, prueba una pregunta de solo lectura, como cuál es la tendencia de tu tasa de conversión de la lista de deseos.

Dos resultados apuntan a correcciones específicas:

• No hay herramientas de SaveTo Wishlist en la lista. Es probable que el cliente siga apuntando al servidor predeterminado, así que comprueba que su URL termine en /stw-agent/mcp. Confirma también que nadie haya desactivado el registro.
• Un error de permisos en cada llamada. Al usuario conectado le falta manage_woocommerce. Cambia el cliente a una cuenta de Gestor de Tienda o Administrador.

---

Cómo activar o desactivar el acceso del agente

El registro de capacidades está activado por defecto e incluye tres interruptores. Dos de ellos son para que los actives.

1. Falta la función. Si wp_register_ability() no está disponible en el sitio, SaveTo Wishlist Pro omite el registro por completo. No hay errores, nada se registra a medias y el plugin continúa con su trabajo normal.

2. Una constante. Establecer STWPRO_DISABLE_ABILITIES en un valor verdadero también omite el registro. Defínela en algún lugar que se cargue antes que los plugins, lo que en la práctica significa wp-config.php o un plugin obligatorio (must-use):

define( 'STWPRO_DISABLE_ABILITIES', true );

3. Un filtro. Devolver true del filtro stwpro_disable_abilities tiene el mismo efecto. Es adecuado para sitios que mantienen este tipo de decisiones dentro de un plugin específico del sitio:

add_filter( 'stwpro_disable_abilities', '__return_true' );

Cualquiera de los tres significa que no se registra ninguna capacidad, por lo que ningún cliente puede descubrirla o llamarla. No hay un estado parcial sobre el que razonar, lo que es útil para un interruptor que quizás necesites activar rápidamente.

---

Lo que esto no hace todavía

La cobertura de IA a menudo omite los límites, así que aquí están los reales.

• Sin compras autónomas. Ninguna de las 15 habilidades permite a un agente realizar un pedido, gastar dinero o finalizar una compra en nombre de un comprador.
• Sin eludir el modelo de permisos. Una cuenta que no puede administrar WooCommerce no puede llamar a estas habilidades pidiendo a un asistente que lo haga en su lugar.
• Un menú fijo, no acceso abierto. Desde SaveTo Wishlist, las 15 habilidades nombradas son la lista completa. Un agente no puede inventar una decimosexta, consultar tablas arbitrarias o acceder a funciones que nadie registró.
• Un cliente todavía tiene que conectarse. Registrar una habilidad no publica nada en la red abierta. Un cliente tiene que conectarse a través de un servidor MCP, con credenciales que pasen las comprobaciones de permisos.
• Solo lee lo que tiene la tienda. Los guardados de un invitado residen en su navegador hasta que inician sesión o se registran. En ese momento, los artículos se mueven a su cuenta y se convierten en datos sobre los que una habilidad puede informar.

En general, la mayoría de estas son deliberadas, no descuidos que esperan un parche. Son el modelo de permisos haciendo su trabajo, lo cual es mejor que una función que otorga silenciosamente más de lo que esperabas.

---

Preguntas frecuentes

---

Prepara tus datos de la lista de deseos de WooCommerce para los agentes

Lo interesante no es que un asistente pueda responder a una pregunta sobre tu tienda. Es que nadie tuvo que crear primero un conector para ese asistente específico. En cambio, un estándar compartido hizo las presentaciones, y los datos de tu lista de deseos estuvieron listos porque ya estaban estructurados, con permisos y nombrados.

Esto es lo que debes hacer:

• Familiarízate con la API de Habilidades de WordPress antes de conectar nada a tu tienda.
• Verifica el modelo de permisos de cualquier plugin que conectes, especialmente si las llamadas automatizadas ejecutan el mismo código que las pantallas de administrador.
• Decide qué información deseas que un agente responda, luego empareja esa información con las habilidades que la devuelven.
• Conecta un cliente a través de tu propio servidor, comenzando con las nueve habilidades de solo lectura.
• Anota los interruptores ahora, para que la decisión ya esté tomada si alguna vez la necesitas rápidamente.
• Establece expectativas con tu equipo sobre lo que un agente no puede hacer aquí.

Los guardados en la lista de deseos son una de las primeras señales de intención que recibe tu tienda. Por eso vale la pena usarlos para la recuperación de carritos abandonados y vale la pena compartirlos con un grupo. Hacer que esos datos sean legibles por agentes de IA es un primer paso práctico hacia el comercio agentivo.