Inteligencia de TikTok ET
API de productos de vendedores de TikTok MCP
Listar los productos ofrecidos por un TikTok vendedor para revisar su surtido y comparar la información de producto disponible.
Prompts y casos de uso de API de productos de vendedores de TikTok
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. Revisa a TikTok surtido de productos del vendedor
Prompt: Revisa a TikTok surtido de productos del vendedor para [seller ID]. 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: Revisa a TikTok surtido de productos del vendedor para [seller ID]. 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: Revisa a TikTok surtido de productos del vendedor para [seller ID]. 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.
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/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_data_et_list_seller_producthttps://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": "data-et-list-seller-product-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_list_seller_product",
"arguments": {
"pageNum": 1,
"pageSize": 20,
"sellerId": "7495514739648989419",
"sellerProductSortField": 1,
"sortType": 1
}
}
}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 |
|---|---|---|---|
sellerId | string | obligatorio | Store ID (TikTok Shop ID). Longitud máxima 1000. Obtenido de los resultados devueltos del "ET TikTok Búsqueda de tiendas" o "ET TikTok Destrezas de tiendas |
sellerProductSortField | integer | opcional | Campos de clasificación de listas: 1= Venta total (total_sale_cnt), 2= Ventas totales (total_sale_gmv_amt), 3=SPU precio promedio (spu_avg_price), ventas de 4=7 días (total_sale_7d_cnt), 5=7 días de ventas (total_sale_gmv_7d_amt) Ejemplo: 1 |
sortType | integer | opcional | Orden de clasificación: 0=ascending (asc), 1=descending (desc) Ejemplo: 1 |
pageSize | integer | opcional | Número de artículos por página. **Debe ser un múltiplo de 10, el máximo es 100**; el límite superior de una sola página en la interfaz oficial es 10, internamente es 10 después de múltiples tiradas por página y luego fusionado Ejemplo: 50 |
pageNum | integer | opcional | Número de página de Paginación, a partir de 1 Ejemplo: 1 |
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 comercial, 200 indica éxito (ver código de error abajo para detalles) |
errmsg | string | opcional | Descripción del estado empresarial |
total | integer | opcional | Número de registros |
products | array | opcional | Lista de productos de la tienda (ver campos de productos abajo para más detalles) |
columns | array | opcional | Rendered columns |
type | string | opcional | Estilo de retroceso |
costToken | integer | opcional | Consume token |
productId | string | opcional | Identificación única del producto ID |
asin | string | opcional | Producto ID (igual que productId) |
imageUrl | string | opcional | Imagen del producto URL |
coverUrl | string | opcional | Imagen de cobertura URL |
productImageUrls | array | opcional | Imagen del producto URL lista |
price | number | opcional | Precio del producto |
spuAvgPrice | number | opcional | SPU precio promedio |
minPrice | number | opcional | precio más bajo |
maxPrice | number | opcional | precio más alto |
currency | string | opcional | Moneda |
totalSaleCnt | integer | opcional | ventas totales |
totalSale1dCnt | integer | opcional | Total de ventas en 1 día (incremental) |
totalSale7dCnt | integer | opcional | Total de ventas dentro de 7 días (incremental) |
totalSale15dCnt | integer | opcional | Total de ventas (incremental) dentro de 15 días |
totalSale30dCnt | integer | opcional | Total de ventas en 30 días (incremental) |
totalSale60dCnt | integer | opcional | Total de ventas en 60 días (incremental) |
totalSale90dCnt | integer | opcional | Total de ventas en 90 días (incremental) |
monthlySalesUnits | integer | opcional | ventas mensuales |
totalSaleGmvAmt | number | opcional | ventas totales |
totalSaleGmv1dAmt | number | opcional | Total de ventas en 1 día (incremental) |
totalSaleGmv7dAmt | number | opcional | Total de ventas (incremental) dentro de 7 días |
totalSaleGmv15dAmt | number | opcional | Total de ventas en 15 días (incremental) |
totalSaleGmv30dAmt | number | opcional | Total de ventas en 30 días (incremental) |
totalSaleGmv60dAmt | number | opcional | Total de ventas en 60 días (incremental) |
totalSaleGmv90dAmt | number | opcional | Total de ventas en 90 días (incremental) |
productRating | number | opcional | calificación del producto |
ratings | integer | opcional | Número de comentarios |
reviewCount | integer | opcional | Número de comentarios |
productCommissionRate | number | opcional | Tasa de comisión de productos (decimal, como 0,05 significa 5%) |
categoryName | string | opcional | Nombre del producto |
categoryIds | array | opcional | Categoría de productos ID lista |
salesFlagText | string | opcional | Cómo traer bienes |
salesTrendFlagText | string | opcional | tendencias de ventas |
firstCrawlDt | integer | opcional | Fecha de lanzamiento (yyyyMMdd formato, como 20240504) |
availableDate | string | opcional | Tiempo de liberación (timestamp/date) |
discount | string | opcional | Información de descuento |
offMarkText | string | opcional | ¿Hay una marca de descuento? |
freeShippingText | string | opcional | ¿Es envío gratis? |
isSShopText | string | opcional | ¿Es una tienda S? |
salePropsInfo | array | opcional | Información del atributo de ventas (incluido propId/propName/salePropValues[propValueId/propValue/image]) |
region | string | opcional | código de área |
sourceType | string | opcional | Fuente de producto |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Revisa a TikTok surtido de productos del vendedor. vendedor ID 7495514739648989419.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra asin: ejemplo-asin; producto id: ejemplo-productId; precio: 19.99. 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
Ejemplo ilustrativo con datos ficticios, no 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": "data-et-list-seller-product-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_list_seller_product",
"arguments": {
"pageNum": 1,
"pageSize": 20,
"sellerId": "7495514739648989419",
"sellerProductSortField": 1,
"sortType": 1
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "data-et-list-seller-product-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"asin\":\"example-asin\",\"productId\":\"example-productId\",\"price\":19.99,\"ratings\":10}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"asin": "example-asin",
"productId": "example-productId",
"price": 19.99,
"ratings": 10
}
]
}
},
"isError": false
}
}