Investigación de productos de Shopee

API de búsqueda de productos de Shopee MCP

Buscar y filtrar productos en mercados de Shopee apoyados en Asia y América Latina para la selección de productos y el mercado. Disponible REST API o MCP.

CosteRecent 10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de búsqueda de productos de Shopee

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 productos Shopee que coincidan con mis criterios de selección

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Continuar los resultados dentro de un límite de página

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Inicio [my selected page] y retorno [my requested page size] dentro de los límites documentados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.

3. Priorizar los resultados para la revisión

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Prioridad [my chosen ranking metric] dentro [my chosen order]. Mantenga la clasificación limitada a los filtros seleccionados y el período de presentación de informes. Para esta selección, elija la puntuación, precio, ventas totales, ventas de 30 días, ingresos de 30 días, favoritos, recuento de puntuación, tiempo de inclusión o ventas estimadas.

4. Encontrar coincidencias por precio total del producto

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen total product price range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

5. Encontrar coincidencias por unidades vendidas

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen units sold range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

6. Encontrar coincidencias por unidades estimadas Vendidas en los últimos 30 días

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen estimated units sold in last 30 days range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

7. Encontrar coincidencias por unidades históricas totales

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen total historical units sold range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

8. Encontrar coincidencias por ingresos de ventas en los últimos 30 días

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen sales revenue in last 30 days range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

9. Encontrar coincidencias por la puntuación del producto

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen product rating range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

10. Encontrar coincidencias por número de valoraciones

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen number of ratings range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

11. Encontrar coincidencias por número de favoritos

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen number of favorites range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

12. Encontrar coincidencias por cuenta de Sku total

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen total sku count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

13. Buscar coincidencias por fecha de lista de productos

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen product listing date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

14. Encontrar coincidencias por fecha de presentación de informes

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen reporting date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

15. Encontrar coincidencias por fecha de observación

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen observation date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

16. Encontrar coincidencias por la fecha de apertura de la tienda

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen store opening date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

17. Elija Cómo Buscar Palabras Match

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Partido [my search words] como [an exact phrase, all words or any word], según mi preferencia. Resumir sólo los registros devueltos.

18. Resultados estrechos por Palabras Excluidas

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected excluded words] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

19. Elija Cómo Excluido Juego de Palabras

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Exclusión de los resultados [my unwanted words] como [an exact phrase, all words or any word]. Resume sólo los registros devueltos.

20. Resultados estrechos por categoría 1 ID

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected level 1 category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

21. Resultados estrechos por categoría 2 ID

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected level 2 category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

22. Resultados estrechos por categoría 3 ID

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected level 3 category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

23. Buscar productos en categorías seleccionadas

Prompt: Encontrar productos Shopee que coincidan [search phrase] dentro [target marketplace] dentro [selected category paths]. Mantener la jerarquía de categoría completa para cada categoría seleccionada y resumir los productos que coincidan.

24. Resultados estrechos por tienda específica ID List, Comma-Separated

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected specific store id list, comma-separated] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

25. Resultados estrechos por tienda no incluida ID List, Comma-Separated

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected excluded store id list, comma-separated] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

26. Resultados estrechos por nombre de tienda o nombre de usuario

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected store name or username] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

27. Elija tiendas locales o de ultramar

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Concéntrate en [local or overseas] tiendas, según mi preferencia. Resumir sólo los registros devueltos.

28. Resultados estrechos por tipo de ubicación de la tienda

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected store location type] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

29. Elija Envío Local o Transfronterizo

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Focus on products shipping [locally or across borders], según mi preferencia. Resumir sólo los registros devueltos.

30. Elija Tiendas Preferentes Shopee

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my preference for Shopee Preferred shops] para reducir los resultados. Resumir sólo los registros devueltos.

31. Encontrar tiendas oficiales

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my preference for official shops] para reducir los resultados. Resumir sólo los registros devueltos.

32. Buscar productos de venta caliente

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my preference for hot-selling products] para reducir los resultados. Resumir sólo los registros devueltos.

33. Resultados estrechos por producto ID List , Comma-Separated

Prompt: Buscar productos Shopee que coincidan con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected product id list , comma-separated] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

Qué debes proporcionar

Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.

Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_shopee_product_search

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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": "shopee-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_shopee_product_search",
    "arguments": {
      "keyword": "phone case",
      "keywordType": 1,
      "page": 1,
      "pageSize": 1000,
      "station": "SG"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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
`station`	`string`	obligatorio	Requerido. Shopee site, acepta nombre o código. Véase la tabla de asignación de sitios a continuación Ejemplo: SG
`keyword`	`string`	opcional	Título del producto keyword Ejemplo: phone case
`keywordType`	`integer`	opcional	Modo de partido: 1= Frases exactas (por defecto), 2=Multi-palabra AND, 3=Multi-word OR Ejemplo: 1
`notExistKeyword`	`string`	opcional	Excluir los productos que contienen esta palabra clave Ejemplo: phone case
`notExistKeywordType`	`integer`	opcional	Modo de exclusión: 1= Frase exacta (por defecto), 2=Multi-palabra AND, 3=Multi-word OR Ejemplo: 1
`priceMin`	`number`	opcional	Precio mínimo del producto total (moneda local) Ejemplo: 1
`priceMax`	`number`	opcional	Precio máximo del producto total Ejemplo: 1
`soldMin`	`integer`	opcional	Unidades mínimas vendidas en los últimos 30 días Ejemplo: 1
`soldMax`	`integer`	opcional	Unidades máximas vendidas en los últimos 30 días Ejemplo: 1
`estimateSoldStart`	`integer`	opcional	Unidades mínimas vendidas en los últimos 30 días Ejemplo: 1
`estimateSoldEnd`	`integer`	opcional	Unidades estimadas máximas vendidas en los últimos 30 días Ejemplo: 1
`historicalSoldStart`	`integer`	opcional	Unidades históricas mínimas vendidas Ejemplo: 1
`historicalSoldEnd`	`integer`	opcional	Total máximo de unidades históricas vendidas Ejemplo: 1
`paymentStart`	`number`	opcional	Ingresos mínimos de ventas en los últimos 30 días Ejemplo: 1
`paymentEnd`	`number`	opcional	Ingresos máximos de ventas en los últimos 30 días Ejemplo: 1
`ratingMin`	`number`	opcional	Valoración mínima de producto (0-5) Ejemplo: 1
`ratingMax`	`number`	opcional	Valoración máxima del producto Ejemplo: 1
`ratingsMin`	`integer`	opcional	Número mínimo de valoraciones Ejemplo: 1
`ratingsMax`	`integer`	opcional	Número máximo de valoraciones Ejemplo: 1
`favoriteMin`	`integer`	opcional	Número mínimo de favoritos Ejemplo: 1
`favoriteMax`	`integer`	opcional	Número máximo de favoritos Ejemplo: 1
`skuNumberStart`	`integer`	opcional	Total mínimo SKU Cuenta Ejemplo: 1
`skuNumberEnd`	`integer`	opcional	Total máximo SKU Cuenta Ejemplo: 1
`listingDateFrom`	`string`	opcional	Lista de productos fecha de inicio del rango (formato: yyyy-MM-dd) Ejemplo: 2026-01-01
`listingDateTo`	`string`	opcional	Punto final de lista de productos (formato: yyyy-MM-dd) Ejemplo: 2026-01-01
`statTimeStart`	`string`	opcional	Inicio del intervalo de tiempo de las estadísticas (formato: yyyy-MM- No. HH:mm:ss)
`statTimeEnd`	`string`	opcional	Fin del rango de tiempo de las estadísticas (formato: yyyy-MM- No. HH:mm:ss)
`lastModiTimeStart`	`string`	opcional	Último comienzo de la gama de tiempo de rastreo (formato: yyyy-MM-dd)
`lastModiTimeEnd`	`string`	opcional	Final de la gama de tiempo de rastreo (formato: yyyy-MM-dd)
`approvedDateStart`	`string`	opcional	Inicio del intervalo de tiempo de apertura de la tienda (formato: yyyy-MM-dd) Ejemplo: 2026-01-01
`approvedDateEnd`	`string`	opcional	Terminal de tiempo de apertura de la tienda (formato: yyyy-MM-dd) Ejemplo: 2026-01-01
`pL1Id`	`string`	opcional	Categoría 1 ID Ejemplo: example-id
`pL2Id`	`string`	opcional	Categoría de nivel 2 ID Ejemplo: example-id
`pL3Id`	`string`	opcional	Categoría 3 ID Ejemplo: example-id
`cidList`	`string`	opcional	Categoría ID lista, camino completo, múltiples grupos separados por
`shopIdList`	`string`	opcional	Tienda específica ID lista, separada por coma
`notExistShopIdList`	`string`	opcional	Tienda excluida ID lista, separada por coma
`merchant`	`string`	opcional	Nombre de la tienda o nombre de usuario
`shopLocation`	`string`	opcional	Localización de la tienda
`shippingIconType`	`integer`	opcional	Tipo de ubicación de la tienda: 0=Local, 1=Overseas Ejemplo: 1
`cbOption`	`integer`	opcional	Origen de envío: 0=Local, 1=Cross-border Ejemplo: 1
`isShopeeVerified`	`integer`	opcional	Preferente: 0=No preferido, 1=Preferido Ejemplo: 1
`isOfficialShop`	`integer`	opcional	Tienda oficial: 0=No, 1=Sí Ejemplo: 1
`isHotSales`	`integer`	opcional	Venta caliente: 0=No caliente, 1=Hot Ejemplo: 1
`pids`	`string`	opcional	Producto ID lista (máximo 500), separada por coma
`orderBy`	`string`	opcional	Campo de clasificación: puntuación, precio, historical_sold (ventas totales), vendidos (30 días de ventas), pago (30 días de ingresos), favorito, calificaciones, gen_time (hora de lista) estimate_sold ( ventas estimadas)
`orderByType`	`string`	opcional	Dirección: ASC (ascendente), DESC (descendente) Ejemplo: DESC
`page`	`integer`	opcional	Número de página (a partir de 1) Ejemplo: 1
`pageSize`	`integer`	opcional	Productos por página (rango 1-1000) Ejemplo: 1000

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`total`	`integer`	opcional	El número actual de registros regresó.
`totalSize`	`integer`	opcional	Número total de resultados.
`sourceType`	`string`	opcional	Tipo fuente: `shopee`.
`columns`	`array`	opcional	Definiciones de columna Render.
`costToken`	`integer`	opcional	Consume token.
`type`	`string`	opcional	Rendering estilo.
`products`	`array`	opcional	Lista de productos (ver campos abajo).
`pid`	`string`	opcional	Producto único ID.
`title`	`string`	opcional	Título del producto.
`description`	`string`	opcional	Descripción del producto.
`imageUrl`	`string`	opcional	Imagen principal del producto URL.
`productUrl`	`string`	opcional	Enlace de producto Shopee.
`shopeeUrl`	`string`	opcional	Enlaces de producto bajo el nombre de dominio Shopee.
`price`	`number`	opcional	Precio por defecto del producto (moneda local).
`minPrice`	`number`	opcional	SKU precio más bajo.
`maxPrice`	`number`	opcional	El precio más alto del SKU.
`sold`	`integer`	opcional	Número de unidades vendidas en los 30 días anteriores.
`estimateSold`	`integer`	opcional	Estimar el número de unidades vendidas en los 30 días anteriores.
`historicalSold`	`integer`	opcional	El número total de artículos vendidos.
`payment`	`number`	opcional	Ventas en los 30 días anteriores (moneda local).
`rating`	`number`	opcional	Valoración de producto (0-5).
`ratings`	`integer`	opcional	Número de valoración.
`favorite`	`integer`	opcional	Número de colecciones.
`viewCount`	`integer`	opcional	Número de opiniones.
`stock`	`integer`	opcional	Cuenta de acciones.
`skuNumber`	`integer`	opcional	SKU cantidad.
`genTime`	`string`	opcional	Tiempo de estante.
`statTime`	`string`	opcional	Hora de las estadísticas.
`lastModiTime`	`string`	opcional	Última hora de rastreo.
`categoryStructure`	`string`	opcional	Carril de estructura de categoría.
`cid`	`string`	opcional	Categoría IDs (comma separado).
`shopId`	`string`	opcional	Store ID.
`shopName`	`string`	opcional	Nombre de la tienda.
`shopUrl`	`string`	opcional	Enlace de tiendas.
`userName`	`string`	opcional	Nombre del dueño de la tienda.
`shopLocation`	`string`	opcional	Localización de la tienda.
`shopProductsCount`	`integer`	opcional	El número total de artículos en la tienda.
`approvedDate`	`string`	opcional	Almacene horas de apertura.
`isOfficialShop`	`integer`	opcional	Es una tienda oficial (1=sí, 0=no).
`isShopeeVerified`	`integer`	opcional	El comprador es preferido (1=sí, 0=no).
`isHotSales`	`integer`	opcional	Es un vendedor caliente (1=sí, 0=no).
`shippingIconType`	`integer`	opcional	Tipo de ubicación de la tienda (0=local, 1=overseas, 3 o null=unknown).
`cbOption`	`integer`	opcional	Ubicación del envío (0=doméstico, 1 = transfronterizo).
`estimatedDays`	`integer`	opcional	Días estimados de llegada.
`status`	`integer`	opcional	Estado del producto (1=normal, 0=removed, 8=excluded from list).
`notExist`	`integer`	opcional	Ya sea que exista (0=existas, 1=no existe).

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Buscar productos Shopee que coincidan con mis criterios de selección. Usar “casa de teléfono”. Concéntrate en Singapur.

Explicación ilustrativa de la respuesta

El resultado ilustrativo muestra el título: Ejemplo producto; precio: 19.99; calificación: 4.5. Estas cifras describen sólo el registro mostrado. A partir de este ejemplo, no se pueden calcular las medidas que faltan.

Sobre esta muestra: Ejemplo ilustrativo con registros ficticios; no procede de una llamada real. Los identificadores, precios y recuentos son datos de demostración.

No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.

Ver el formato de solicitud y respuesta MCP

Ejemplos