Investigación de productos de Shopee
API de detalles de productos de Shopee MCP
Retrieve public Shopee product details from a validated marketplace URL. Llame al detalle del producto Shopee API mediante REST o MCP en su aplicación o AI agente.
Prompts y casos de uso de API de detalles 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. Look Up Shopee Detalles del producto
Prompt: Look Up Shopee Detalles del producto para [product link]. Mostrar los resultados disponibles e identificar claramente la información que falta.
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.
La muestra de respuesta publicada y el texto explicativo discrepan sobre la estructura de productos y los campos disponibles. Los ejemplos detallados de precios, acciones y análisis de variantes están pendientes de aclaración.
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_shopee_product_detailhttps://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": "shopee-product-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_shopee_product_detail",
"arguments": {
"productUrl": "https://shopee.sg/example-i.9641401.29691169956"
}
}
}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 |
|---|---|---|---|
productUrl | string | obligatorio | HTTPS producto URL on shopee.sg, shopee.co.id, shopee.com.my, shopee.ph, shopee.co.th, shopee.tw, shopee.vno shopee.com.br; el camino termina en -i.shopId>.<itemIdØ, sin puerto ni puerto 443 Ejemplo: https://shopee.sg/example-i.9641401.29691169956 |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de estado de las empresas; `200` indica éxito. |
errmsg | string | opcional | Mensaje del estado de las empresas; `ok` sobre el éxito. |
data | array | opcional | array de productos Shopee; fijo a 1 artículo sobre el éxito. |
total | integer | opcional | Corregido `1` sobre el éxito. |
costToken | integer | opcional | Consume token. |
type | string | opcional | Corregido `tableListWorkbenches`. |
columns | array | opcional | Columnas rendidas generadas en base a campos de productos comunes. |
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
Obtén los detalles públicos de un producto de Shopee a partir de una URL de mercado validada.
Respuesta de ejemplo
En la muestra publicada, el primer registro mostrado es “Logitech Flip Folio para iPad Pro " Air - Graphite " . Su precio comunicado es 138. Su calificación notificada es 4.8. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.
Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo.
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
{
"productUrl": "https://shopee.sg/product-i.120981896.43103076730"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"data": [
{
"priceMax": 138,
"rating": 4.8,
"shopName": "Logitech Official Store",
"description": "Key Product Description\n\nLogitech Flip Folio for iPad Pro & Air - Graphite\n\nRemovable Keyboard Keyboard can be stowed away when not needed, reducing weight for on-the-go use. One Size Fits Two One model fits both iPad Pro and iPad Air (13\" or 11\"), making it easier to choose and stock.\n\n\n\nProduct Information\n\nWeight: 1.02kg\n\nDimensions: 32cm x 23cm x 3cm\n\n\n\nAdditional Information\n\nPlease refer to the product packaging for full product information.",
"priceMin": 138,
"tierVariations": [
{
"images": [
"sg-11134301-7rau3-mb6gmdd2iew9f5",
"sg-11134301-7rasf-mb6cu58d5ieu55"
],
"name": "Default",
"options": [
"13 inch",
"11 inch"
]
}
],
"shopRating": 4.912435,
"price": 138,
"currency": "SGD",
"shopId": "120981896",
"categoryBreadcrumb": [
"Computers & Accessories",
"Keyboards & Mice",
"Keyboards"
],
"brand": "Logitech",
"image": "https://down-sg.img.susercontent.com/file/sg-11134301-7ravc-majmq0zszs3728",
"models": [
{
"name": "13 inch",
"tier_index": [
0
],
"model_id": "248478921359",
"is_pre_order": false,
"status": 1
},
{
"name": "11 inch",
"tier_index": [
1
],
"model_id": "280434604246",
"is_pre_order": false,
"status": 1
}
],
"images": [
"https://down-sg.img.susercontent.com/file/sg-11134301-7ravc-majmq0zszs3728",
"https://down-sg.img.susercontent.com/file/sg-11134301-7ravo-majmqorse7361a",
"https://down-sg.img.susercontent.com/file/sg-11134301-7ravj-majn87vymz4h2b",
"https://down-sg.img.susercontent.com/file/sg-11134301-7rate-majmqzgclt1sd0",
"https://down-sg.img.susercontent.com/file/sg-11134301-7rav9-majmqrz7i9gi5c",
"https://down-sg.img.susercontent.com/file/sg-11134301-7rat5-majmqs0bgmwz32",
"https://down-sg.img.susercontent.com/file/sg-11134301-7raun-majmqrz7jnyb4e",
"https://down-sg.img.susercontent.com/file/sg-11134301-7rau3-majmqrzhngmra4",
"https://down-sg.img.susercontent.com/file/sg-11134301-7rasp-majmqu9m5o1v83"
],
"discountPercent": 46,
"shopLocation": "SG",
"url": "https://shopee.sg/product-i.120981896.43103076730",
"isOfficialShop": true,
"itemId": "43103076730",
"name": "Logitech Flip Folio for iPad Pro & Air - Graphite",
"attributes": [
{
"name": "Bundle Set",
"value": "No"
},
{
"name": "Gaming Focused",
"value": "No"
}
],
"categoryId": "100644"
}
],
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "itemId",
"sortable": true,
"title": "商品 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "shopId",
"sortable": true,
"title": "店铺 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "url",
"sortable": true,
"title": "商品链接"
},
{
"filterable": true,
"cellType": "text",
"field": "name",
"sortable": true,
"title": "商品名称"
},
{
"filterable": true,
"cellType": "text",
"field": "image",
"sortable": true,
"title": "主图链接"
},
{
"filterable": true,
"cellType": "text",
"field": "images",
"sortable": true,
"title": "商品图片列表"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "当前价格"
},
{
"filterable": true,
"cellType": "number",
"field": "priceBeforeDiscount",
"sortable": true,
"title": "折前价格"
},
{
"filterable": true,
"cellType": "number",
"field": "priceMin",
"sortable": true,
"title": "最低价格"
},
{
"filterable": true,
"cellType": "number",
"field": "priceMax",
"sortable": true,
"title": "最高价格"
},
{
"filterable": true,
"cellType": "number",
"field": "discountPercent",
"sortable": true,
"title": "折扣百分比"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "货币代码"
},
{
"filterable": true,
"cellType": "number",
"field": "stock",
"sortable": true,
"title": "总库存"
},
{
"filterable": true,
"cellType": "number",
"field": "sold",
"sortable": true,
"title": "累计售出数量"
},
{
"filterable": true,
"cellType": "number",
"field": "soldDisplayed",
"sortable": true,
"title": "页面展示售出数量"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "商品评分"
},
{
"filterable": true,
"cellType": "number",
"field": "ratingCount",
"sortable": true,
"title": "评分数量"
},
{
"filterable": true,
"cellType": "number",
"field": "likedCount",
"sortable": true,
"title": "点赞数量"
},
{
"filterable": true,
"cellType": "number",
"field": "commentCount",
"sortable": true,
"title": "评论数量"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewsFetched",
"sortable": true,
"title": "本次抓取评论数量"
},
{
"filterable": true,
"cellType": "text",
"field": "reviewSummary",
"sortable": true,
"title": "评论统计摘要"
},
{
"filterable": true,
"cellType": "text",
"field": "shopName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "number",
"field": "shopRating",
"sortable": true,
"title": "店铺评分"
},
{
"filterable": true,
"cellType": "text",
"field": "shopLocation",
"sortable": true,
"title": "店铺所在地"
},
{
"filterable": true,
"cellType": "text",
"field": "isOfficialShop",
"sortable": true,
"title": "是否官方店铺"
},
{
"filterable": true,
"cellType": "text",
"field": "isCrossBorder",
"sortable": true,
"title": "是否跨境商品"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryId",
"sortable": true,
"title": "类目 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌"
},
{
"filterable": true,
"cellType": "text",
"field": "tierVariations",
"sortable": true,
"title": "销售属性"
},
{
"filterable": true,
"cellType": "text",
"field": "models",
"sortable": true,
"title": "SKU 变体及库存"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryBreadcrumb",
"sortable": true,
"title": "类目路径"
},
{
"filterable": true,
"cellType": "text",
"field": "videos",
"sortable": true,
"title": "商品视频"
},
{
"filterable": true,
"cellType": "text",
"field": "description",
"sortable": true,
"title": "商品描述"
},
{
"filterable": true,
"cellType": "text",
"field": "attributes",
"sortable": true,
"title": "商品规格属性"
},
{
"filterable": true,
"cellType": "number",
"field": "estimatedShippingDays",
"sortable": true,
"title": "预计发货天数"
},
{
"filterable": true,
"cellType": "text",
"field": "isFreeShipping",
"sortable": true,
"title": "是否免运费"
},
{
"filterable": true,
"cellType": "text",
"field": "scrapedAt",
"sortable": true,
"title": "抓取时间"
}
],
"type": "tableListWorkbenches"
}
}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": "shopee-product-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_shopee_product_detail",
"arguments": {
"productUrl": "https://shopee.sg/product-i.120981896.43103076730"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "shopee-product-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"name\":\"Logitech Flip Folio for iPad Pro & Air - Graphite\",\"price\":138,\"rating\":4.8,\"priceMax\":138,\"shopName\":\"Logitech Official Store\",\"description\":\"Key Product Description\\n\\nLogitech Flip Folio for iPad Pro & Air - Graphite\\n\\nRemovable Keyboard Keyboard can be stowed away when not needed, reducing weight for on-the-go use. One Size Fits Two One model fits both iPad Pro and iPad Air (13\\\" or 11\\\"), making it easier to choose and stock.\\n\\n\\n\\nProduct Information\\n\\nWeight: 1.02kg\\n\\nDimensions: 32cm x 23cm x 3cm\\n\\n\\n\\nAdditional Information\\n\\nPlease refer to …\",\"priceMin\":138,\"tierVariations\":[{\"name\":\"Default\",\"images\":[\"sg-11134301-7rau3-mb6gmdd2iew9f5\",\"sg-11134301-7rasf-mb6cu58d5ieu55\"],\"options\":[\"13 inch\",\"11 inch\"]}],\"shopRating\":4.912435,\"currency\":\"SGD\",\"shopId\":\"120981896\",\"categoryBreadcrumb\":[\"Computers & Accessories\",\"Keyboards & Mice\"]}],\"total\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"name": "Logitech Flip Folio for iPad Pro & Air - Graphite",
"price": 138,
"rating": 4.8,
"priceMax": 138,
"shopName": "Logitech Official Store",
"description": "Key Product Description\n\nLogitech Flip Folio for iPad Pro & Air - Graphite\n\nRemovable Keyboard Keyboard can be stowed away when not needed, reducing weight for on-the-go use. One Size Fits Two One model fits both iPad Pro and iPad Air (13\" or 11\"), making it easier to choose and stock.\n\n\n\nProduct Information\n\nWeight: 1.02kg\n\nDimensions: 32cm x 23cm x 3cm\n\n\n\nAdditional Information\n\nPlease refer to …",
"priceMin": 138,
"tierVariations": [
{
"name": "Default",
"images": [
"sg-11134301-7rau3-mb6gmdd2iew9f5",
"sg-11134301-7rasf-mb6cu58d5ieu55"
],
"options": [
"13 inch",
"11 inch"
]
}
],
"shopRating": 4.912435,
"currency": "SGD",
"shopId": "120981896",
"categoryBreadcrumb": [
"Computers & Accessories",
"Keyboards & Mice"
]
}
],
"total": 1
}
},
"isError": false
}
}