Inteligencia comercial de TikTok CJ
API de detalles de directos de TikTok MCP
Buscar detalles de un TikTok Livestream. Los resultados se devuelven como datos JSON estructurados. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de detalles 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. Buscar detalles de un TikTok livestream
Prompt: Buscar detalles de un TikTok livestream para [record ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Reseña Conversión de Seguidor de corriente activa
Prompt: Mira. TikTok livestream [record ID] dentro [supported country] con detalles básicos. Mostrar nuevos seguidores y la fracción de conversión de seguidor retornado, junto a su categoría. Explicar cualquier conversión porcentual y no inferir conversión de ventas.
3. Compara la conversión de Audience Livestream
Prompt: Consulta las transmisiones en directo [live ID A] y [live ID B] dentro [supported country] con detalles básicos en dos solicitudes separadas. Compare los recuentos de nuevos seguidores y fracciones de conversión de seguidores, manteniendo las categorías y el contexto de mercado visible. Compare las tarifas sólo cuando las definiciones coinciden, y no infiere ventas, ingresos o causación.
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_chuhaijiang_tiktok_live_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": "chuhaijiang-tiktok-live-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_live_detail",
"arguments": {
"country": "us",
"id": "7643101948819835678",
"include": "core"
}
}
}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 |
|---|---|---|---|
country | string | obligatorio | Mercado de solicitudes de minúscula. Regresados country_code puede diferir; preservar ambos. Ejemplo: us |
id | string | obligatorio | Livestream ID devuelto por su operación de búsqueda. Mantenga los identificadores como cadenas para evitar la pérdida de precisión. Ejemplo: 7643101948819835678 |
include | string | opcional | Expansiones separadas por el sistema: núcleo. Solicito sólo expansiones necesarias. Ejemplo: core |
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 | 200 significa éxito |
errmsg | string | opcional | `ok` sobre el éxito |
request_id | string | opcional | Solicitud de rastreo ID |
data | object | opcional | La información básica está en `data.items[]`; cuando es `include=core`, también hay `data.core.items[]` |
id | string | opcional | Sala de difusión en vivo ID |
country_code | string | opcional | Código del país |
most_product_category_label | string | opcional | Principales categorías de productos |
core_new_follow_count | number | opcional | Número de nuevos fans |
core_follower_conversion_rate | number | opcional | Tasa de conversión de aficionados |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Buscar detalles de un TikTok Livestream. Registro de uso ID 7643101948819835678. Centrarse en el US.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra id: 7643101948819835678. 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": "chuhaijiang-tiktok-live-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_live_detail",
"arguments": {
"country": "us",
"id": "7643101948819835678",
"include": "core"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-live-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"items\":[{\"id\":\"7643101948819835678\"}]}}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"items": [
{
"id": "7643101948819835678"
}
]
}
}
},
"isError": false
}
}