WooCommerce
Marcas de productos de WooCommerce API MCP
Tienda oficial anónima de sólo lectura API datos. No hay llave mercante o OAuth es necesario. La disponibilidad depende de la versión y configuración de la tienda. Las reseñas protegidas por contraseña siguen ocultas. Cada solicitud cuesta 10 créditos. Las solicitudes fallidas se reembolsan automáticamente.
Prompts y casos de uso de Marcas de productos de WooCommerce API
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Buscar marcas de tiendas
Prompt: Listar las marcas públicas [store URL], mostrando nombres devueltos y cuentas de producto.
2. Encontrar contenido de la tienda de coincidencias
Prompt: Listar las marcas públicas [store URL], mostrando nombres devueltos y cuentas de producto. Restrict this request to [search words] dentro de la misma tienda.
3. Lea otra página de resultados de la tienda
Prompt: Listar las marcas públicas [store URL], mostrando nombres devueltos y cuentas de producto. Leer página [page number] con [one to 100 results per page]. Mantener la misma tienda y filtros. Parar en la página solicitada o cuando no quedan más resultados.
4. Elija si incluye los Términos de uso
Prompt: Listar las marcas públicas [store URL], mostrando nombres devueltos y cuentas de producto. Ocultar términos sin productos para la navegación comercial, o incluirlos cuando necesito inspeccionar la estructura de taxonomía pública de la tienda.
Qué debes proporcionar
Proporciona la URL raíz pública HTTPS de la tienda o la ruta de instalación de WordPress, junto con identificadores de esa misma tienda. Estas consultas públicas no requieren una clave de comerciante ni credenciales OAuth.
La compatibilidad y la visibilidad pública varían según la tienda. Distingue los valores nulos de los resultados vacíos o iguales a cero; no intentes eludir la protección por contraseña.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_woocommerce_product_brandshttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "woocommerce-product-brands-1",
"method": "tools/call",
"params": {
"name": "nexscope_woocommerce_product_brands",
"arguments": {
"storeUrl": "https://example.com"
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
storeUrl | string | obligatorio | Público HTTPS tienda root o WordPress ruta de instalación. Ejemplo: https://example.com |
pageNum | integer | opcional | Número de página, predeterminado 1. Ejemplo: 1 |
pageSize | integer | opcional | Tamaño de página, por defecto 20, máximo 100. Ejemplo: 20 |
keyword | string | opcional | Buscar en esta tienda; a la mayoría de 200 caracteres. Ejemplo: shirt |
hideEmpty | boolean | opcional | Ocultar términos sin productos; predeterminados a la configuración verdadera de la tienda. Ejemplo: true |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 indica que la solicitud se ha aceptado o se ha completado correctamente; cualquier valor distinto de cero indica un error de la plataforma. |
cost | string | obligatorio | Milliseconds pasados, nunca créditos; -1 solicitudes fuera de la web. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Tiempo local del servidor: yyyy-MM- No. HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Época milisegundos. |
Opción 1 de cualquier alternativa — requiere storeUrl, fetchedAt, cacheHit, brands, pageNum, pageSize
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.brands | array | obligatorio | Datos públicos normalizados. Los valores opcionales perdidos son cadenas nulas o vacías. Ejemplo: [] |
data.brands[] | object | obligatorio | Datos públicos normalizados. Los valores opcionales perdidos son cadenas nulas o vacías. |
data.brands[].count | any | opcional | Conteo de productos asociados, nulo cuando no está disponible. |
data.brands[].description | string | obligatorio | Texto de la traducción o público URL; vacío cuando no está disponible. Las imágenes no se recogen. Ejemplo: |
data.brands[].id | string | obligatorio | Función de la tienda ID cuerda. Ejemplo: 1 |
data.brands[].imageUrl | string | obligatorio | Texto de la traducción o público URL; vacío cuando no está disponible. Las imágenes no se recogen. Ejemplo: |
data.brands[].name | string | obligatorio | Nombre de texto. Ejemplo: Color |
data.brands[].parentId | any | opcional | Parent ID; 0 es un término raíz, null significa no disponible. |
data.brands[].slug | string | obligatorio | Texto de la traducción o público URL; vacío cuando no está disponible. Las imágenes no se recogen. Ejemplo: blue |
data.brands[].url | string | obligatorio | Texto de la traducción o público URL; vacío cuando no está disponible. Las imágenes no se recogen. Ejemplo: |
data.cacheHit | boolean | obligatorio | Si la respuesta fue recibida de la caché anónima de 60 segundos. Ejemplo: false |
data.fetchedAt | string | obligatorio | Tómese el tiempo en la época milisegundos; conservado en golpes de caché. Ejemplo: 1792972800000 |
data.hasMore | any | opcional | Null cuando las páginas totales aguas arriba no están disponibles. |
data.pageNum | integer | obligatorio | Los metadatos de pagination; los totales omitidos se null. Ejemplo: 1 |
data.pageSize | integer | obligatorio | Los metadatos de pagination; los totales omitidos se null. Ejemplo: 20 |
data.storeUrl | string | obligatorio | Identidad normalizada de la tienda. Ejemplo: https://example.com |
data.total | any | opcional | Los metadatos de pagination; los totales omitidos se null. |
data.totalPages | any | opcional | Los metadatos de pagination; los totales omitidos se null. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.brands[].count | integer | opcional | Conteo de productos asociados, nulo cuando no está disponible. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.brands[].count | null | opcional | Conteo de productos asociados, nulo cuando no está disponible. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.brands[].parentId | string | opcional | Parent ID; 0 es un término raíz, null significa no disponible. Ejemplo: 0 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.brands[].parentId | null | opcional | Parent ID; 0 es un término raíz, null significa no disponible. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.hasMore | boolean | opcional | Null cuando las páginas totales aguas arriba no están disponibles. Ejemplo: false |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.hasMore | null | opcional | Null cuando las páginas totales aguas arriba no están disponibles. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.total | integer | opcional | Los metadatos de pagination; los totales omitidos se null. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.total | null | opcional | Los metadatos de pagination; los totales omitidos se null. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.totalPages | integer | opcional | Los metadatos de pagination; los totales omitidos se null. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.totalPages | null | opcional | Los metadatos de pagination; los totales omitidos se null. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
Preguntas y respuestas de ejemplo
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
Tu pregunta
Mostrar las dos primeras marcas públicas en cipherskincare.com.
Respuesta de ejemplo
La muestra devuelve la marca Cipher con un recuento de productos de 14. Las páginas totales y si existen más resultados no están disponibles, por lo que esta respuesta no establece que Cipher es la única marca.
Sobre esta muestra: Extracto de una muestra de la documentación publicada; no son datos actuales ni el resultado de una llamada en vivo. La muestra publicada conserva los datos originales completos; aquí pueden abreviarse las listas y los textos largos. Los valores de negocio se conservan de la muestra publicada. Los tiempos y metadatos de trazabilidad que exige la envoltura externa son marcadores ilustrativos porque la fuente publicada no los incluye.
Ver los datos de ejemplo publicados (JSON)
Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.
Ejemplo de datos
Ejemplo de solicitud y respuesta
Parámetros de solicitud
{
"storeUrl": "https://cipherskincare.com",
"pageSize": 2
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"storeUrl": "https://cipherskincare.com",
"brands": [
{
"id": "126",
"name": "Cipher",
"slug": "cipher",
"description": "",
"parentId": "0",
"count": 14,
"imageUrl": "",
"url": "https://cipherskincare.com/brand/cipher/"
}
],
"pageNum": 1,
"pageSize": 2,
"total": null,
"totalPages": null,
"hasMore": null,
"fetchedAt": "1793089718636",
"cacheHit": false
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "woocommerce-product-brands-example",
"method": "tools/call",
"params": {
"name": "nexscope_woocommerce_product_brands",
"arguments": {
"storeUrl": "https://cipherskincare.com",
"pageSize": 2
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "woocommerce-product-brands-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"storeUrl\":\"https://cipherskincare.com\",\"brands\":[{\"id\":\"126\",\"name\":\"Cipher\",\"slug\":\"cipher\",\"description\":\"\",\"parentId\":\"0\",\"count\":14,\"imageUrl\":\"\",\"url\":\"https://cipherskincare.com/brand/cipher/\"}],\"pageNum\":1,\"pageSize\":2,\"total\":null,\"totalPages\":null,\"hasMore\":null,\"fetchedAt\":\"1793089718636\",\"cacheHit\":false},\"cost\":\"-1\",\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"storeUrl": "https://cipherskincare.com",
"brands": [
{
"id": "126",
"name": "Cipher",
"slug": "cipher",
"description": "",
"parentId": "0",
"count": 14,
"imageUrl": "",
"url": "https://cipherskincare.com/brand/cipher/"
}
],
"pageNum": 1,
"pageSize": 2,
"total": null,
"totalPages": null,
"hasMore": null,
"fetchedAt": "1793089718636",
"cacheHit": false
},
"cost": "-1",
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
},
"isError": false
}
}