Inteligencia comercial de TikTok CJ
API de detalles de vídeos de TikTok MCP
Mira hacia arriba TikTok video para el contenido y la investigación de la competencia. Llama a la TikTok Detalle de vídeo API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de detalles de vídeos 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. Mira hacia arriba TikTok video para el contenido y la investigación de la competencia
Prompt: Mira hacia arriba TikTok video para la investigación de contenidos y competidores [record ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Revisar señales de comercio de vídeo
Prompt: Mira. TikTok video [record ID] dentro [supported country] con detalles básicos. Mostrar el regreso 30 días GPM y autor promedio tasa de compromiso, manteniendo sus etiquetas y unidades. No inventes un GPM fórmula o comparar tarifas diferentes definidas.
3. Comparar Comercio y compromiso Señales para Dos Vídeos
Prompt: Recuperar vídeos [video ID A] y [video ID B] dentro [supported country] con detalles básicos en dos solicitudes. Compare su regreso 30 días GPM y las tasas de participación de autorpromedio lado a lado, preservando las unidades suministradas. Bandera de escalas incomparables o no definidas; no conviertan la participación del autor en el compromiso del vídeo individual o inferir un GPM fórmula.
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_video_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-video-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_video_detail",
"arguments": {
"country": "us",
"id": "6788833646091504902",
"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 | Video ID devuelto por su operación de búsqueda. Mantenga los identificadores como cadenas para evitar la pérdida de precisión. Ejemplo: 6788833646091504902 |
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[]` |
author_avg_engagement_rate | number | opcional | Tasa media de interacción del autor |
core_video_30d_gpm | object/number | opcional | 30 días GPM |
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
Mira hacia arriba TikTok video para el contenido y la investigación de la competencia. Registro de uso ID 6788833646091504902. Centrarse en el US.
Respuesta de ejemplo
En la muestra publicada, la media de reproducciones del vídeo es 24473994.777777776, su duración es 13491 y la media de «me gusta» es 538050.6666666666. Estas observaciones solo corresponden al registro y al período 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
{
"id": "6788833646091504902",
"country": "us",
"include": "core"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": {
"core": {
"total_count": 1,
"items": [
{
"core_video_share_count": 38455,
"core_video_id": "6788833646091504902",
"core_video_like_play_ratio": 0.021891336169654333,
"core_video_like_count": 4793588,
"core_country_code": "US",
"id": "6788833646091504902",
"core_video_collect_count": 29796,
"core_video_comment_count": 4249,
"core_video_30d_gpm": {
"unit": "US",
"value": 0
},
"core_video_engagement_rate": 0.022086356605242233,
"core_video_play_count": 218971924
}
]
},
"total_count": 1,
"items": [
{
"video_avg_play_count": 24473994.777777776,
"video_cover": {
"thumb_url": "",
"url": "https://oss-t.chuhaijiang.com/v11/os/ttm_product_video/v-6788833646091504902/5d6a56f1bcce4645a2c069c4678872bb_1580650609~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?sign=REDACTED"
},
"user_avatar": {
"thumb_url": "",
"url": "https://oss-t.chuhaijiang.com/v1/os/ttm_user/u-6787436989987357701/073d29954e037c114bfa39659fde7c89~tplv-tiktokx-cropcenter:168:168.webp?sign=REDACTED"
},
"video_duration": 13491,
"account_type": 0,
"unique_id": "thesortarican",
"is_ad": false,
"is_aigc_video": false,
"video_avg_like_count": 538050.6666666666,
"follower_count": 510809,
"had_product": false,
"video_launch_time": "1580648510000",
"country_code": "US",
"last_update_time": "1792843947944",
"uid": "6787436989987357701",
"has_comment": true,
"share_url": "https://www.tiktok.com/@thesortarican/video/6788833646091504902?_r=1&u_code=f0fhgf7hj0c83c&preview_pb=0&sharer_language=en&_d=f0g20e7bd4milj&share_item_id=6788833646091504902&source=h5_m",
"nickname": "Matt Silva",
"video_count": 29,
"id": "6788833646091504902",
"author_avg_engagement_rate": 0.05511975951901423,
"video_desc": "Coming to America tribute makeup. #fyp #featureme #makeup #funny #lol #tiktok #foryou #meme #beauty"
}
]
},
"request_id": "4cd15438-312d-4598-972a-a6de8c726dc0"
}
}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": "chuhaijiang-tiktok-video-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_video_detail",
"arguments": {
"id": "6788833646091504902",
"country": "us",
"include": "core"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-video-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"items\":[{\"id\":\"6788833646091504902\",\"video_avg_play_count\":24473994.777777776,\"video_cover\":{\"thumb_url\":\"\",\"url\":\"https://oss-t.chuhaijiang.com/v11/os/ttm_product_video/v-6788833646091504902/5d6a56f1bcce4645a2c069c4678872bb_1580650609~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?sign=REDACTED\"},\"user_avatar\":{\"thumb_url\":\"\",\"url\":\"https://oss-t.chuhaijiang.com/v1/os/ttm_user/u-6787436989987357701/073d29954e037c114bfa39659fde7c89~tplv-tiktokx-cropcenter:168:168.webp?sign=REDACTED\"},\"video_duration\":13491,\"unique_id\":\"thesortarican\",\"is_ad\":false,\"is_aigc_video\":false,\"video_avg_like_count\":538050.6666666666,\"follower_count\":510809,\"had_product\":false,\"video_launch_time\":\"1580648510000\"}],\"core\":{\"items\":[{\"id\":\"6788833646091504902\",\"core_video_share_count\":38455,\"core_video_id\":\"6788833646091504902\",\"core_video_like_play_ratio\":0.021891336169654333,\"core_video_like_count\":4793588,\"core_country_code\":\"US\",\"core_video_collect_count\":29796,\"core_video_comment_count\":4249,\"core_video_30d_gpm\":{\"value\":0,\"unit\":\"US\"},\"core_video_engagement_rate\":0.022086356605242233,\"core_video_play_count\":218971924}],\"total_count\":1},\"total_count\":1},\"request_id\":\"4cd15438-312d-4598-972a-a6de8c726dc0\"}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"items": [
{
"id": "6788833646091504902",
"video_avg_play_count": 24473994.777777776,
"video_cover": {
"thumb_url": "",
"url": "https://oss-t.chuhaijiang.com/v11/os/ttm_product_video/v-6788833646091504902/5d6a56f1bcce4645a2c069c4678872bb_1580650609~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?sign=REDACTED"
},
"user_avatar": {
"thumb_url": "",
"url": "https://oss-t.chuhaijiang.com/v1/os/ttm_user/u-6787436989987357701/073d29954e037c114bfa39659fde7c89~tplv-tiktokx-cropcenter:168:168.webp?sign=REDACTED"
},
"video_duration": 13491,
"unique_id": "thesortarican",
"is_ad": false,
"is_aigc_video": false,
"video_avg_like_count": 538050.6666666666,
"follower_count": 510809,
"had_product": false,
"video_launch_time": "1580648510000"
}
],
"core": {
"items": [
{
"id": "6788833646091504902",
"core_video_share_count": 38455,
"core_video_id": "6788833646091504902",
"core_video_like_play_ratio": 0.021891336169654333,
"core_video_like_count": 4793588,
"core_country_code": "US",
"core_video_collect_count": 29796,
"core_video_comment_count": 4249,
"core_video_30d_gpm": {
"value": 0,
"unit": "US"
},
"core_video_engagement_rate": 0.022086356605242233,
"core_video_play_count": 218971924
}
],
"total_count": 1
},
"total_count": 1
},
"request_id": "4cd15438-312d-4598-972a-a6de8c726dc0"
}
},
"isError": false
}
}