Inteligencia de TikTok KD
API de detalles de análisis de productos de TikTok MCP
Review a TikTok precio del producto, ventas, ingresos, comisión y detalles de la tienda. Llamada vía REST API o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de detalles de análisis de productos 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 Ejecución del producto
Prompt: Examen TikTok Rendimiento del producto [product ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en una moneda seleccionada
Prompt: Examen TikTok Rendimiento del producto [product 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.
3. Investigación en un idioma seleccionado
Prompt: Examen TikTok Rendimiento del producto [product ID] dentro [target marketplace]. Volver las descripciones disponibles en [my preferred supported language], manteniendo los identificadores sin cambios.
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_product_analytics_apihttps://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-product-analytics-api-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_analytics_api",
"arguments": {
"productId": "1732505564636812173",
"region": "US"
}
}
}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 |
|---|---|---|---|
productId | string | obligatorio | TikTok producto ID. Ejemplo: 1732505564636812173 |
region | string | opcional | TikTok Región del mercado de tiendas. Ejemplo: US |
currency | string | opcional | Código de moneda. Ejemplo: USD |
language | string | opcional | Lenguaje de respuesta. Ejemplo: en-US |
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 | Datos de los productos, fijados a 1 matriz de elementos cuando exitoso |
costToken | integer | opcional | El token de deducción para esta llamada es generalmente `14000` |
errmsg | string | opcional | Mensaje de estado, `ok` sobre el éxito |
product_id | string | opcional | Producto único ID (estring, to avoid loss of large integer accuracy) |
product_name | string | opcional | Nombre del producto |
product_region | string | opcional | El region/market donde se encuentra el producto, como `us` |
product_shop_id | string | opcional | Store ID |
pri_cate_id | string | opcional | Categoría de primer nivel ID |
sec_cate_id | string | opcional | Categoría secundaria ID |
ter_cate_id | string | opcional | Categoría de tercer nivel ID |
unit_price | number | opcional | Precio unitario solicitado `currency` moneda |
min_price | number | opcional | Precio más bajo solicitado `currency` moneda |
max_price | number | opcional | Precio más alto solicitado `currency` moneda |
revenue | number | opcional | Total sales/GMV solicitado `currency` moneda |
sales_volumn | integer | opcional | Volumen de ventas, campo deletreado `volumn` |
commission_rate | number | opcional | Tasa de comisión, porcentaje directo, `25.0` significa 25% |
product_review_count | integer | opcional | Número de reseñas de productos |
launch_date | string | opcional | Fecha en los estantes`YYYY-MM-DD`) |
delivery_type | string | opcional | Método de envío, como `local` |
video_number | integer | opcional | Número de vídeos asociados |
video_revenue | number | opcional | Ventas generadas por video solicitado `currency` moneda |
live_number | integer | opcional | Número de transmisiones en directo asociadas |
live_revenue | number | opcional | Ventas generadas por streaming en directo, solicitadas `currency` moneda |
shopping_mall_revenue | number | opcional | Ventas de mercado solicitadas `currency` moneda |
creator_number | integer | opcional | Número de personas conectadas |
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
Revisa a TikTok precio del producto, ventas, ingresos, comisión y detalles de la tienda. Uso del producto ID 1729524572095485660. Centrarse en el US.
Respuesta de ejemplo
En la muestra publicada, su nombre de producto reportado es [NEW][OFFICIAL d'Alba] Trufa blanca Primer rayo suero PRO 2X. Sus ingresos notificados son 62590. El valor indicado de el volumen de ventas es 2845. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes 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
{
"productId": "1729524572095485660",
"region": "US"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"sec_cate_id": "848776",
"product_region": "us",
"creator_number": 778,
"video_revenue": 50358,
"sales_volumn": 2845,
"video_number": 1282,
"ter_cate_id": "601615",
"unit_price": 22,
"product_name": "[NEW][OFFICIAL d'Alba] White Truffle First Spray Serum PRO 2X",
"revenue": 62590,
"max_price": 22,
"min_price": 22,
"delivery_type": "local",
"product_review_count": 733,
"product_id": "1729524572095485660",
"pri_cate_id": "601450",
"live_number": 247,
"commission_rate": 14.000000000000002,
"launch_date": "2026-09-22",
"shopping_mall_revenue": 418,
"product_description": [
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/78e97bbce2154981a8bee3e91027c8ff~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/78e97bbce2154981a8bee3e91027c8ff~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/78e97bbce2154981a8bee3e91027c8ff",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fe453c360ba749858b8a883d459535e2~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fe453c360ba749858b8a883d459535e2~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/fe453c360ba749858b8a883d459535e2",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c469584628fb4164a3e22a1a2db0a7be~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c469584628fb4164a3e22a1a2db0a7be~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/c469584628fb4164a3e22a1a2db0a7be",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/5bce6c1b5844407384c4b7b975cf3e5f~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/5bce6c1b5844407384c4b7b975cf3e5f~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/5bce6c1b5844407384c4b7b975cf3e5f",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/833ebcb6a0f24bddb4c985c737f5c5b4~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/833ebcb6a0f24bddb4c985c737f5c5b4~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/833ebcb6a0f24bddb4c985c737f5c5b4",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/5a713f9f73864e429cf72046ee6e3c1c~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/5a713f9f73864e429cf72046ee6e3c1c~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/5a713f9f73864e429cf72046ee6e3c1c",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/09e3d9689d0f43ab8d198a3be05d9ce1~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/09e3d9689d0f43ab8d198a3be05d9ce1~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1669,
"uri": "tos-useast5-i-omjb5zjo8w-tx/09e3d9689d0f43ab8d198a3be05d9ce1",
"height": 1252
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/ad3db778f05d41bcbf1743d507877967~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/ad3db778f05d41bcbf1743d507877967~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/ad3db778f05d41bcbf1743d507877967",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/cf529e943c3a407ab377ff62db38f39e~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/cf529e943c3a407ab377ff62db38f39e~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/cf529e943c3a407ab377ff62db38f39e",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/82d4a43519944781ac48c0ff6c1e3c22~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/82d4a43519944781ac48c0ff6c1e3c22~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/82d4a43519944781ac48c0ff6c1e3c22",
"height": 1267
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/865bf71d80de401b898cedec11292ed4~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/865bf71d80de401b898cedec11292ed4~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086"
],
"width": 1689,
"uri": "tos-useast5-i-omjb5zjo8w-tx/865bf71d80de401b898cedec11292ed4",
"height": 1267
},
"type": "image"
}
],
"product_shop_id": "7494221571082258140",
"live_revenue": 11814
}
]
}
}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": "tiktok-product-analytics-api-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_analytics_api",
"arguments": {
"productId": "1729524572095485660",
"region": "US"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "tiktok-product-analytics-api-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"product_name\":\"[NEW][OFFICIAL d'Alba] White Truffle First Spray Serum PRO 2X\",\"revenue\":62590,\"sales_volumn\":2845,\"sec_cate_id\":\"848776\",\"product_region\":\"us\",\"creator_number\":778,\"video_revenue\":50358,\"video_number\":1282,\"ter_cate_id\":\"601615\",\"unit_price\":22,\"max_price\":22,\"min_price\":22}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"product_name": "[NEW][OFFICIAL d'Alba] White Truffle First Spray Serum PRO 2X",
"revenue": 62590,
"sales_volumn": 2845,
"sec_cate_id": "848776",
"product_region": "us",
"creator_number": 778,
"video_revenue": 50358,
"video_number": 1282,
"ter_cate_id": "601615",
"unit_price": 22,
"max_price": 22,
"min_price": 22
}
]
}
},
"isError": false
}
}