Inteligencia de TikTok KD
API de análisis de directos de TikTok MCP
Compare TikTok shopping livestreams por ventas de ingresos, espectadores y productos vendidos. Llamada vía REST API o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de análisis de directos 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. Compare TikTok Compras Livestreams
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en un idioma seleccionado
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Volver las descripciones disponibles en [my preferred supported language], manteniendo los identificadores sin cambios.
3. Investigación en una moneda seleccionada
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.
4. Revise un período específico de presentación de informes
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales.
5. Continuar los resultados dentro de un límite de página
Prompt: Compare TikTok Compras Livestreams para [livestream ID] 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.
6. Priorizar los resultados para la revisión
Prompt: Compare TikTok Compras Livestreams para [livestream ID] 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.
7. Encontrar coincidencias por seguidores del Creador
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Limitación de los resultados [my chosen creator follower range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
8. Resultados estrechos por categoría ID
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Uso [my selected category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
9. Resultados estrechos por tienda ID
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Uso [my selected shop id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
10. Resultados estrechos por Creador ID
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Uso [my selected creator id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
11. Resultados estrechos por producto ID
Prompt: Compare TikTok Compras Livestreams para [livestream ID] dentro [target marketplace]. Uso [my selected product id] 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/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_livestream_analyticshttps://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-livestream-analytics-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_livestream_analytics",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"sortField": {}
}
}
}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 |
|---|---|---|---|
region | string | opcional | Region/market código, e.g., US. Longitud máxima 1000 Ejemplo: US |
dateRange | string | opcional | Rango de tiempo, e.g., last7Day (los últimos 7 días), last30Day (los últimos 30 días). Longitud máxima 1000 Ejemplo: last30Day |
pageNumber | integer | opcional | Número de página, rango de valor 1-5 (desde el rango devuelve errcode 501) Ejemplo: 1 |
pageSize | integer | opcional | Artículos por página, rango de valor 5-100 Ejemplo: 10 |
language | string | opcional | Lenguaje de retorno, e.g. zh-CN, en-US. Longitud máxima 1000 |
currency | string | opcional | Unidad de moneda e.g., USD. Longitud máxima 1000 |
sortField | object | opcional | Clasificar criterios, estructura definida por la puerta de entrada; pasar un objeto vacío {} por orden de rango predeterminado cuando no ordenar Ejemplo: {} |
category_id | string | opcional | Categoría ID filtro |
shop_id | string | opcional | Tienda ID filtro |
creator_id | string | opcional | Creador ID filtro |
product_id | string | opcional | Producto ID filtro |
followers_range | string | opcional | Filtro de gama de seguidores del Creador |
livestreamId | string | opcional | Objetivo directo único ID (camelCase), e.g., 7661409374878878494. Típicamente obtenida del livestream_id en el punto final de rango directo. Longitud máxima 1000 |
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 la operación; `200` indica que se ha completado correctamente |
data | array | opcional | Lista de transmisión en vivo o detalles de transmisión en vivo |
costToken | integer | opcional | El token de deducción para esta llamada se fija a `14000` |
errmsg | string | opcional | Mensaje de estado, `ok` sobre el éxito |
livestream_start_time | integer | opcional | Tiempo de inicio de transmisión en vivo (epoch milliseconds) |
livestream_end_time | integer | opcional | Tiempo de transmisión en vivo (epoch milliseconds) |
livestream_duration | integer | opcional | Duración de la transmisión en vivo (segundos) |
livestream_title | string | opcional | Título en vivo |
livestream_id | string | opcional | El único ID de la transmisión en vivo (una cadena para evitar la pérdida de gran precisión del entero), que se puede utilizar como la `livestreamId` de la interfaz de detalles |
creator_id | string | opcional | El único ID of the expert (string, to avoid loss of large integer accuracy) |
creator_handle | string | opcional | Expert account handle |
revenue | string | opcional | Total sales/GMV, devuelto por solicitud `currency`; devuelto como una cuerda, como `"185590.52"` |
unit_price | string | opcional | El precio unitario de la pieza es devuelto según el pedido `currency`; el retorno es una cadena, como `"265.89"` |
views | integer | opcional | Número de opiniones |
record_type | string | opcional | Tipo de registro, como `SHORT` |
livestream_id | string | opcional | Transmisión en vivo única ID, de conformidad con lo solicitado `livestreamId` |
livestream_title | string | opcional | Título en vivo, como `24 HOUR STREAM` |
creator_id | string | opcional | El único ID of the expert (string, to avoid loss of large integer accuracy) |
creator_handle | string | opcional | Expert username/handle, como `pokepiglt` |
livestream_start_time | integer | opcional | Tiempo de inicio de transmisión en vivo, época milisegundos |
livestream_end_time | integer | opcional | Tiempo de transmisión en vivo, época milisegundos |
livestream_duration | integer | opcional | Duración de transmisión en vivo, segundos de unidad |
record_type | string | opcional | Tipo de registro, como `SHORT` |
viewers | integer | opcional | Número de espectadores; uso `viewers` para detalles y `views` para listas |
revenue | number | opcional | Vivir sales/GMV, devuelto por solicitud `currency`; detalles son de tipo numérico |
gpm | number | opcional | GMV per mille, GMV por mil impresiones; detalles exclusivos |
product_number | integer | opcional | Número de bienes entregados en vivo |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Compare TikTok shopping livestreams por ventas de ingresos, espectadores y productos vendidos. Centrarse en el US.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra ingresos: 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.
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",
"page": 1,
"size": 5
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"livestream_start_time": "1790105782000",
"livestream_duration": 29998,
"revenue": "327961.84",
"livestream_title": "",
"creator_id": "6677756329987228678",
"livestream_id": "7688445351061195533",
"creator_handle": "byenblanfaktori",
"unit_price": "7.73",
"livestream_end_time": "1790135780000",
"views": 408515,
"record_type": "SHORT"
},
{
"livestream_start_time": "1789468902000",
"livestream_duration": 522419,
"revenue": "124951.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7685709140785728287",
"creator_handle": "based",
"unit_price": "27.83",
"livestream_end_time": "1789991321000",
"views": 3813644,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790143565000",
"livestream_duration": 4489,
"revenue": "122173.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7688607461032348446",
"creator_handle": "based",
"unit_price": "28.38",
"livestream_end_time": "1790148054000",
"views": 35956,
"record_type": "SHORT"
},
{
"livestream_start_time": "1789948635000",
"livestream_duration": 21369,
"revenue": "105431.93",
"livestream_title": "Ripping The Hottest Sports Cards",
"creator_id": "6688398622600692742",
"livestream_id": "7687770584767318815",
"creator_handle": "burtonbreaks",
"unit_price": "184.0",
"livestream_end_time": "1789970004000",
"views": 359696,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790338081000",
"livestream_duration": 127381,
"revenue": "104258.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7689442635441834782",
"creator_handle": "based",
"unit_price": "28.38",
"livestream_end_time": "1790465462000",
"views": 1064234,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790355613000",
"livestream_duration": 43808,
"revenue": "104146.5",
"livestream_title": "MINT MONEY STAR ROBE DROP 💚💸",
"creator_id": "6787875411281134598",
"livestream_id": "7689518323038128910",
"creator_handle": "jeffreestar",
"unit_price": "28.59",
"livestream_end_time": "1790399421000",
"views": 497834,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790383058000",
"livestream_duration": 20813,
"revenue": "98712.94",
"livestream_title": "Hola❤️",
"creator_id": "6800598044448457733",
"livestream_id": "7689636419756706591",
"creator_handle": ".brendaayala1",
"unit_price": "29.7",
"livestream_end_time": "1790403871000",
"views": 315245,
"record_type": "SHORT"
},
{
"livestream_start_time": "1789992320000",
"livestream_duration": 4512,
"revenue": "94207.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7687957811115969310",
"creator_handle": "based",
"unit_price": "29.9",
"livestream_end_time": "1789996832000",
"views": 32863,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790092508000",
"livestream_duration": 14896,
"revenue": "87770.93",
"livestream_title": "💝Medicube x Nello Collab Mega💝",
"creator_id": "7291517492299007018",
"livestream_id": "7688388230848219917",
"creator_handle": "medicube_official_shop",
"unit_price": "34.31",
"livestream_end_time": "1790107404000",
"views": 61503,
"record_type": "FULL"
},
{
"livestream_start_time": "1790017706000",
"livestream_duration": 12414,
"revenue": "79376.5",
"livestream_title": "",
"creator_id": "7014603102829593606",
"livestream_id": "7688067090044963598",
"creator_handle": "simplymandys",
"unit_price": "37.65",
"livestream_end_time": "1790030120000",
"views": 80987,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790355686000",
"livestream_duration": 10779,
"revenue": "73958.43",
"livestream_title": "NOELY FAJAS MEGA LIVE",
"creator_id": "6801519791112897542",
"livestream_id": "7689518679498787614",
"creator_handle": "noelyfajas",
"unit_price": "89.65",
"livestream_end_time": "1790366465000",
"views": 75247,
"record_type": "FULL"
},
{
"livestream_start_time": "1790270453000",
"livestream_duration": 51829,
"revenue": "72404.21",
"livestream_title": "",
"creator_id": "6829169369835127814",
"livestream_id": "7689152573131066125",
"creator_handle": "calicurvesfajas",
"unit_price": "65.7",
"livestream_end_time": "1790322282000",
"views": 222287,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790355124000",
"livestream_duration": 36821,
"revenue": "70073.0",
"livestream_title": "Fajas colombianas 🇨🇴",
"creator_id": "7179385436960310318",
"livestream_id": "7689516256734530317",
"creator_handle": "alondrixsexycurves",
"unit_price": "118.17",
"livestream_end_time": "1790391945000",
"views": 165052,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790295054000",
"livestream_duration": 23887,
"revenue": "68666.76",
"livestream_title": "Hola!!❤️",
"creator_id": "6800598044448457733",
"livestream_id": "7689258465444760351",
"creator_handle": ".brendaayala1",
"unit_price": "26.07",
"livestream_end_time": "1790318941000",
"views": 281085,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790108377000",
"livestream_duration": 3533,
"revenue": "64389.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7688456553828993823",
"creator_handle": "based",
"unit_price": "28.59",
"livestream_end_time": "1790111910000",
"views": 40296,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790249163000",
"livestream_duration": 127738,
"revenue": "63659.89",
"livestream_title": "RIPS ALL DAYYY!!!",
"creator_id": "6906678272890848261",
"livestream_id": "7689060444446722847",
"creator_handle": "allpoketcg",
"unit_price": "142.42",
"livestream_end_time": "1790376901000",
"views": 167774,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790116436000",
"livestream_duration": 2818,
"revenue": "62098.65",
"livestream_title": "FAST PACED TECH Nick",
"creator_id": "7617890876685108238",
"livestream_id": "7688491201942522655",
"creator_handle": "refreshed.tech",
"unit_price": "459.99",
"livestream_end_time": "1790119254000",
"views": 13763,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790285688000",
"livestream_duration": 31709,
"revenue": "54655.29",
"livestream_title": "",
"creator_id": "7043091206013060102",
"livestream_id": "7689218099326225165",
"creator_handle": "glamourmodernfashion1",
"unit_price": "73.07",
"livestream_end_time": "1790317397000",
"views": 66047,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790268132000",
"livestream_duration": 12027,
"revenue": "50930.0",
"livestream_title": "",
"creator_id": "7042472144287466543",
"livestream_id": "7689142531280046879",
"creator_handle": "djounefelix5",
"unit_price": "339.53",
"livestream_end_time": "1790280159000",
"views": 51296,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790035193000",
"livestream_duration": 2237,
"revenue": "48597.51",
"livestream_title": "Ripping The Hottest Sports Cards",
"creator_id": "6688398622600692742",
"livestream_id": "7688142341407853343",
"creator_handle": "burtonbreaks",
"unit_price": "109.95",
"livestream_end_time": "1790037430000",
"views": 5878,
"record_type": "SHORT"
}
]
}
}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-livestream-analytics-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_livestream_analytics",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"sortField": {}
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "tiktok-livestream-analytics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":19.99}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 19.99
}
]
}
},
"isError": false
}
}