Inteligencia comercial de TikTok CJ

API de productos relacionados con directos de TikTok MCP

Encontrar productos ofrecidos en un TikTok Livestream. Llama a la TikTok Productos relacionados con la vida API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent 38 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de productos relacionados con 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. Encontrar productos ofrecidos en un TikTok livestream

Prompt: Encontrar productos ofrecidos en un TikTok livestream para [record ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Continuar los resultados dentro de un límite de página

Prompt: Encontrar productos ofrecidos en un TikTok livestream para [record 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.

3. Reseña Ventas y Vendedores de Productos Livestream

Prompt: Encontrar productos ofrecidos en un TikTok livestream para [record ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta. Comparar productos devueltos vendidos cuenta y GMV junto con información de vendedor y categoría. Mantenga las monedas y los períodos de observación separados; no asuma que todos los productos en el flujo vivo fueron devueltos.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_chuhaijiang_tiktok_live_related_products

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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-related-products-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_live_related_products",
    "arguments": {
      "country": "us",
      "id": "7643101948819835678",
      "page": 1,
      "pageSize": 3
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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
`page`	`integer`	opcional	Número de página, empezando en 1. No hay paginación automática. Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, de 1 a 10. La omisión preserva el predeterminado de arriba. Ejemplo: 3

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 lista de productos está en `data.items[]` y el total `data.total_count`
`tiktok_live_detail_product_country_code`	`string`	opcional	Código del país producto
`tiktok_live_detail_product_sold_count`	`number`	opcional	Ventas relacionadas con emisiones en vivo
`tiktok_live_detail_product_gmv`	`object`	opcional	Transmisión en vivo asociada GMV
`tiktok_live_detail_product_seller_avatar`	`object`	opcional	Vendedor avatar
`tiktok_live_detail_product_seller_info`	`array`	opcional	Texto de descripción del vendedor
`tiktok_live_detail_product_seller_category_name_label`	`string`	opcional	Etiquetas de clasificación del vendedor

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

Encontrar productos ofrecidos en un TikTok Livestream. Registro de uso ID 7643101948819835678. Centrarse en el US.

Respuesta de ejemplo

En la muestra publicada, el título del producto asociado a la transmisión es «BASED Deluxe Straight/Wavy Hair Kit | Shampoo, Conditioner, Texture Powder, Hair Clay, Pomade, Sea Salt Spray + Wooden Comb | Non-Toxic, High Performance». Su categoría de segundo nivel (l2) es 848904 y el recuento de unidades vendidas es 5927. 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

{
  "pageSize": 3,
  "page": 1,
  "country": "us",
  "id": "7643101948819835678"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": {
      "total_count": 50,
      "items": [
        {
          "tiktok_live_detail_product_title": "BASED Deluxe Straight/Wavy Hair Kit | Shampoo, Conditioner, Texture Powder, Hair Clay, Pomade, Sea Salt Spray + Wooden Comb | Non-Toxic, High Performance",
          "tiktok_live_detail_product_id": "1732307769700553014",
          "tiktok_live_detail_product_l2_category": "848904",
          "tiktok_live_detail_product_sold_count": 5927,
          "tiktok_live_detail_product_country_code": "US",
          "tiktok_live_detail_product_images": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1732307769700553014/4f6f3aada7bb44568f48e065189b73b5~tplv-fhlh96nyum-crop-webp:1500:1500.webp?sign=REDACTED"
          },
          "tiktok_live_detail_product_seller_id": "7495079418085345590",
          "tiktok_live_detail_product_l3_category": "601469",
          "tiktok_live_detail_product_l1_category": "601450",
          "tiktok_live_detail_product_floor_price": {
            "unit": "US",
            "value": 70
          },
          "tiktok_live_detail_product_seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1732349151895064886/c4e48f5ff0b242968e1d6212f3ab93f0~tplv-fhlh96nyum-resize-webp:300:300.webp?sign=REDACTED"
          },
          "tiktok_live_detail_product_seller_category_name_label": "601450",
          "tiktok_live_detail_product_conversion_rate": 0.0014,
          "tiktok_live_detail_product_gmv": {
            "unit": "US",
            "value": 312945.6000000002
          },
          "tiktok_live_detail_product_seller_info": [
            "This seller has successfully passed a verification process that validates their authenticity.",
            "Based Bodyworks LLC"
          ],
          "id": "1732307769700553014",
          "tiktok_live_detail_product_seller_name": "BASED",
          "tiktok_live_detail_product_ceiling_price": {
            "unit": "US",
            "value": 70
          }
        },
        {
          "tiktok_live_detail_product_title": "BASED Shower Duo | Shampoo + Conditioner | Deep Clean, Hydrates, Soothes Scalp, Boosts Volume | Fresh Peppermint | Premium Non-Toxic Formula | 12oz Each",
          "tiktok_live_detail_product_id": "1729473286945083702",
          "tiktok_live_detail_product_l2_category": "848904",
          "tiktok_live_detail_product_sold_count": 5011,
          "tiktok_live_detail_product_country_code": "US",
          "tiktok_live_detail_product_images": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1729473286945083702/e470c055c6c94d429476b8db071d00b6~tplv-fhlh96nyum-crop-webp:1500:1500.webp?sign=REDACTED"
          },
          "tiktok_live_detail_product_seller_id": "7495079418085345590",
          "tiktok_live_detail_product_l3_category": "601469",
          "tiktok_live_detail_product_l1_category": "601450",
          "tiktok_live_detail_product_floor_price": {
            "unit": "US",
            "value": 34
          },
          "tiktok_live_detail_product_commission_rate_num": 0.2,
          "tiktok_live_detail_product_seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1732349151895064886/c4e48f5ff0b242968e1d6212f3ab93f0~tplv-fhlh96nyum-resize-webp:300:300.webp?sign=REDACTED"
          },
          "tiktok_live_detail_product_seller_category_name_label": "601450",
          "tiktok_live_detail_product_conversion_rate": 0.0012,
          "tiktok_live_detail_product_gmv": {
            "unit": "US",
            "value": 138303.60000000006
          },
          "tiktok_live_detail_product_seller_info": [
            "This seller has successfully passed a verification process that validates their authenticity.",
            "Based Bodyworks LLC"
          ],
          "id": "1729473286945083702",
          "tiktok_live_detail_product_seller_name": "BASED",
          "tiktok_live_detail_product_ceiling_price": {
            "unit": "US",
            "value": 34
          }
        },
        {
          "tiktok_live_detail_product_title": "BASED Curly Duo: Premium Non-Toxic Curl Cream & Leave-In Conditioner Bundle - Defines Curls, Controls Frizz, Medium Hold with Agave & Silk Protein, Instant Hydration & Nourishment, No Harsh Chemicals",
          "tiktok_live_detail_product_id": "1731298158877905206",
          "tiktok_live_detail_product_l2_category": "848904",
          "tiktok_live_detail_product_sold_count": 4929,
          "tiktok_live_detail_product_country_code": "US",
          "tiktok_live_detail_product_images": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1731298158877905206/5c937a99c6ed48f9b7dbf0659508a752~tplv-fhlh96nyum-crop-webp:1500:1500.webp?sign=REDACTED"
          },
          "tiktok_live_detail_product_seller_id": "7495079418085345590",
          "tiktok_live_detail_product_l3_category": "981512",
          "tiktok_live_detail_product_l1_category": "601450",
          "tiktok_live_detail_product_floor_price": {
            "unit": "US",
            "value": 30
          },
          "tiktok_live_detail_product_commission_rate_num": 0.2,
          "tiktok_live_detail_product_seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1732349151895064886/c4e48f5ff0b242968e1d6212f3ab93f0~tplv-fhlh96nyum-resize-webp:300:300.webp?sign=REDACTED"
          },
          "tiktok_live_detail_product_seller_category_name_label": "601450",
          "tiktok_live_detail_product_conversion_rate": 0.0011,
          "tiktok_live_detail_product_gmv": {
            "unit": "US",
            "value": 118296
          },
          "tiktok_live_detail_product_seller_info": [
            "This seller has successfully passed a verification process that validates their authenticity.",
            "Based Bodyworks LLC"
          ],
          "id": "1731298158877905206",
          "tiktok_live_detail_product_seller_name": "BASED",
          "tiktok_live_detail_product_ceiling_price": {
            "unit": "US",
            "value": 30
          }
        }
      ]
    },
    "request_id": "55a44771-b8b4-4845-9f47-6340d177402d"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos