Inteligencia de TikTok ET
API de detalles de vendedores de TikTok MCP
Review a TikTok ventas de vendedores, seguidores, calificaciones, productos y contenido promocional. Llamada vía REST API o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de detalles 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. Examen TikTok Performance
Prompt: Examen TikTok Rendimiento del vendedor [seller ID]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Revise las señales de servicio del vendedor
Prompt: Examen TikTok Rendimiento del vendedor [seller ID]. Mostrar los resultados disponibles e identificar claramente la información que falta. Mostrar puntuación, cuenta de revisión, retroalimentación positiva, tasas de respuesta y entrega con unidades de fuente. Los valores ausentes no cuentan como servicio fallido.
3. Compara Vendedor Ventas Windows
Prompt: Examen TikTok Rendimiento del vendedor [seller ID]. Mostrar los resultados disponibles e identificar claramente la información que falta. Compare unidades de siete días, 30 días y 90 días y GMV en columnas separadas. No añadir periodos superpuestos o interpretar GMV como beneficio vendedor.
4. Revise el surtido del vendedor y el alcance del Creador
Prompt: Examen TikTok Rendimiento del vendedor [seller ID]. Mostrar los resultados disponibles e identificar claramente la información que falta. Mostrar listado contra recuentos de productos arrastrados, información de la categoría y creador devuelto, video y cuenta en vivo. Mantenga la cobertura explícita en lugar de asumir que el rastreador vio toda la tienda.
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_tiktok_seller_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": "tiktok-seller-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_seller_detail",
"arguments": {
"sellerId": "7496162162184128712"
}
}
}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 | TikTok vendedor IDObtainable from the "Nexscope TikTok Resultados de la habilidad de búsqueda del vendedor (nexscope-echotik-list-seller) o del ID en un enlace de tienda conocido. Longitud máxima 1000 Ejemplo: 7496162162184128712 |
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 |
costToken | integer | opcional | Consume token |
columns | array | opcional | Definiciones de columna rendidas (metadatos de reproducción) |
type | string | opcional | Estilo rendido (como `tableListWorkbenches`) |
sellerId | string | opcional | Store ID |
sellerName | string | opcional | Nombre de la tienda |
sellerLink | string | opcional | Enlace de la tienda |
coverUrl | string | opcional | Dirección de cubierta de almacén |
region | string | opcional | zona |
categoryId | string | opcional | Clasificación de primer nivel ID |
categoryL2Id | string | opcional | Clasificación secundaria ID |
categoryL3Id | string | opcional | Clasificación de tercer nivel ID |
totalSaleCnt | integer | opcional | ventas totales |
totalSale1dCnt | integer | opcional | Volumen de ventas en el último día (incremental) |
totalSale7dCnt | integer | opcional | Volumen de ventas en los últimos 7 días (incremental) |
totalSale30dCnt | integer | opcional | Volumen de ventas en los últimos 30 días (incremental) |
totalSale90dCnt | integer | opcional | Volumen de ventas en los últimos 90 días (incremental) |
totalSaleGmvAmt | number | opcional | ventas totales |
totalSaleGmv1dAmt | number | opcional | Ventas en el último día (incremental) |
totalSaleGmv7dAmt | number | opcional | Ventas en los últimos 7 días (incremental) |
totalSaleGmv30dAmt | number | opcional | Ventas en los últimos 30 días (incremental) |
totalSaleGmv90dAmt | number | opcional | Ventas en los últimos 90 días (incremental) |
followersCount | integer | opcional | Número de fans |
rating | number | opcional | Valoración |
reviewCount | integer | opcional | Número de opiniones |
positiveFeedbackRate | number | opcional | Valoración positiva |
responseRate | number | opcional | Tasa de respuesta |
deliveryRate | integer | opcional | Tasa de entrega |
totalProductCnt | integer | opcional | Número histórico de artículos en la tienda (incluyendo la eliminación de estantes) |
totalCrawlProductCnt | integer | opcional | Número de artículos en la tienda |
spuAvgPrice | number | opcional | Precio medio del producto SKU en la tienda |
minPrice | integer | opcional | precio más bajo |
maxPrice | integer | opcional | precio más alto |
totalIflCnt | integer | opcional | Número total de personas que transportan bienes |
totalVideoCnt | integer | opcional | Número total de vídeos entregados |
totalLiveCnt | integer | opcional | Total de emisiones en directo |
salesFlagText | string | opcional | Principales métodos de entrega (entrega de vídeo / entrega en vivo) |
salesTrendFlagText | string | opcional | Tendencia de ventas (rising/declining/stable) |
shopIdentityLabel | string | opcional | Logo de la tienda (como OFFICIAL SHOP) |
shopTypeText | string | opcional | Ya sea una tienda de marca (yes/no) |
fromFlagText | string | opcional | Identificación transfronteriza (doméstica / transfronteriza) |
productCategoryList | string | opcional | Categoría de productosJSON string, including category_name / category_id) |
mostProductCategoryList | string | opcional | TOP1 clasificación de productos (JSON cadena) |
firstCrawlDt | integer | opcional | Tiempo estimado de liberación, yyyyMMdd formato (como 20240504 representa 2024-05-04) |
userId | string | opcional | Maestro UID |
sourceType | string | opcional | Fuente de producto (como TikTok) |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Revisa a TikTok ventas de vendedores, seguidores, calificaciones, productos y contenido promocional. vendedor ID 7496162162184128712.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra la puntuación: 4.5; vendedor id: 7496162162184128712. 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.
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
{
"region": "US",
"sellerId": "8650766540691773721"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"totalSale30dCnt": 0,
"categoryL3Id": "601302",
"totalSale1dCnt": 0,
"salesTrendFlagText": "平稳",
"rating": 4.8,
"type": "tableListWorkbenches",
"salesFlagText": "视频带货",
"totalSale90dCnt": 0,
"totalIflCnt": 1,
"sellerId": "8650766540691773721",
"sourceTool": "EchoTik-店铺详情",
"shopTypeText": "否",
"reviewCount": 0,
"totalSaleCnt": 653,
"totalSaleGmv1dAmt": 0,
"totalSaleGmv90dAmt": 0,
"fromFlagText": "本土",
"totalSaleGmv30dAmt": 0,
"firstCrawlDt": 20261002,
"coverUrl": "https://agent-files.linkfox.com/tiktok/20261003/8650766540691773721.jpg",
"sourceType": "Tiktok",
"minPrice": 65,
"followersCount": 0,
"maxPrice": 65,
"region": "ES",
"spuAvgPrice": 65.37,
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "sellerId",
"sortable": true,
"title": "小店ID"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerName",
"sortable": true,
"title": "小店名称"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerLink",
"sortable": true,
"title": "小店链接"
},
{
"filterable": true,
"cellType": "text",
"field": "coverUrl",
"sortable": true,
"title": "店铺封面地址"
},
{
"filterable": true,
"cellType": "text",
"field": "region",
"sortable": true,
"title": "地区"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryId",
"sortable": true,
"title": "一级分类ID"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryL2Id",
"sortable": true,
"title": "二级分类ID"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryL3Id",
"sortable": true,
"title": "三级分类ID"
},
{
"filterable": true,
"cellType": "text",
"field": "productCategoryList",
"sortable": true,
"title": "商品分类"
},
{
"filterable": true,
"cellType": "text",
"field": "mostProductCategoryList",
"sortable": true,
"title": "TOP1商品分类"
},
{
"filterable": true,
"cellType": "text",
"field": "fromFlagText",
"sortable": true,
"title": "跨境标识"
},
{
"filterable": true,
"cellType": "text",
"field": "salesFlagText",
"sortable": true,
"title": "主要带货方式"
},
{
"filterable": true,
"cellType": "text",
"field": "salesTrendFlagText",
"sortable": true,
"title": "销售趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "shopTypeText",
"sortable": true,
"title": "是否品牌店铺"
},
{
"filterable": true,
"cellType": "text",
"field": "shopIdentityLabel",
"sortable": true,
"title": "店铺标识"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评价数"
},
{
"filterable": true,
"cellType": "number",
"field": "positiveFeedbackRate",
"sortable": true,
"title": "好评率"
},
{
"filterable": true,
"cellType": "number",
"field": "responseRate",
"sortable": true,
"title": "回复率"
},
{
"filterable": true,
"cellType": "number",
"field": "deliveryRate",
"sortable": true,
"title": "送达率"
},
{
"filterable": true,
"cellType": "number",
"field": "followersCount",
"sortable": true,
"title": "粉丝数"
},
{
"filterable": true,
"cellType": "number",
"field": "minPrice",
"sortable": true,
"title": "最低价格"
},
{
"filterable": true,
"cellType": "number",
"field": "maxPrice",
"sortable": true,
"title": "最高价格"
},
{
"filterable": true,
"cellType": "number",
"field": "spuAvgPrice",
"sortable": true,
"title": "店铺内商品SKU均价"
},
{
"filterable": true,
"cellType": "number",
"field": "totalCrawlProductCnt",
"sortable": true,
"title": "在店商品数"
},
{
"filterable": true,
"cellType": "number",
"field": "totalProductCnt",
"sortable": true,
"title": "历史在店商品数(含下架)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalIflCnt",
"sortable": true,
"title": "总带货达人数"
},
{
"filterable": true,
"cellType": "number",
"field": "totalLiveCnt",
"sortable": true,
"title": "总直播数"
},
{
"filterable": true,
"cellType": "number",
"field": "totalVideoCnt",
"sortable": true,
"title": "总带货视频数"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleCnt",
"sortable": true,
"title": "总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale1dCnt",
"sortable": true,
"title": "最近1天销量(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale7dCnt",
"sortable": true,
"title": "最近7天销量(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale30dCnt",
"sortable": true,
"title": "最近30天销量(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale90dCnt",
"sortable": true,
"title": "最近90天销量(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmvAmt",
"sortable": true,
"title": "总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv1dAmt",
"sortable": true,
"title": "最近1天销售额(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv7dAmt",
"sortable": true,
"title": "最近7天销售额(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv30dAmt",
"sortable": true,
"title": "最近30天销售额(增量)"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv90dAmt",
"sortable": true,
"title": "最近90天销售额(增量)"
},
{
"filterable": true,
"cellType": "text",
"field": "userId",
"sortable": true,
"title": "达人UID"
},
{
"filterable": true,
"cellType": "number",
"field": "firstCrawlDt",
"sortable": true,
"title": "预估上架时间"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "商品来源"
},
{
"filterable": true,
"cellType": "text",
"field": "type",
"sortable": true,
"title": "渲染的样式"
},
{
"filterable": true,
"cellType": "text",
"field": "columns",
"sortable": true,
"title": "渲染的列"
},
{
"filterable": true,
"cellType": "number",
"field": "costToken",
"sortable": true,
"title": "消耗token"
}
],
"sellerName": "OrinBliss",
"totalSaleGmv7dAmt": 0,
"shopIdentityLabel": "",
"totalProductCnt": 1,
"totalSaleGmvAmt": 42686.61,
"mostProductCategoryList": "[]",
"totalVideoCnt": 1,
"totalLiveCnt": 0,
"userId": "7686331493279040534",
"totalSale7dCnt": 0,
"productCategoryList": "[]",
"totalCrawlProductCnt": 9,
"sellerLink": "aweme://user/profile/7686331493279040534?sec_uid=MS4wLjABAAAAe9aj3K3gx6wKcDw7_bymjjiVKimHeif3heLjIQ0piVppZM5RyCBig6YaWEnfSaKL&from_scene=8",
"categoryL2Id": "842248",
"categoryId": "601152"
}
}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": "tiktok-seller-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_seller_detail",
"arguments": {
"sellerId": "7496162162184128712"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "tiktok-seller-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"sellerId\":\"7496162162184128712\",\"rating\":4.5}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"sellerId": "7496162162184128712",
"rating": 4.5
}
},
"isError": false
}
}