Inteligencia de TikTok KD

API de análisis de productos de TikTok MCP

Análisis TikTok Compra las tablas de productos y precio de nivel de producto, ventas, ingresos, comisión, estado de la lista y datos de la tienda. Llámalo REST API o MCP.

CosteRecent Avg. 22 · Range 11–22 créditos por llamadaPrueba en línea

Prompts y casos de uso de API 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 Shop producto rendimiento

Prompt: Examen TikTok Shop el rendimiento del producto para [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 Shop el rendimiento del producto para [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 Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Volver las descripciones disponibles en [my preferred supported language], manteniendo los identificadores sin cambios.

4. Revise un período específico de presentación de informes

Prompt: Examen TikTok Shop el rendimiento del producto para [product 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: Examen TikTok Shop el rendimiento del producto para [product 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: Examen TikTok Shop el rendimiento del producto para [product 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 ingresos / GMV

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Limitación de los resultados [my chosen revenue / gmv range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

8. Buscar coincidencias por precio de unidad de producto

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Limitación de los resultados [my chosen product unit-price range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

9. Resultados estrechos por categoría ID Lista

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my selected category id list] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

10. Resultados estrechos por tienda ID

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my selected shop id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

11. Resultados estrechos por Creador ID

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my selected creator id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

12. Resultados estrechos por productos de retorno asociados con el vídeo especificado

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my selected return products associated with the specified video] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

13. Productos de revisión de un Livestream

Prompt: Ejecución de la revisión [product ID] dentro [target marketplace], limitado a productos asociados con [livestream ID]. Resumir las métricas de producto disponibles para esa selección.

14. Buscar productos de afiliado

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my affiliate-product preference] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

15. Resultados estrechos de la Comisión de Afiliados E.G

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my selected affiliate commission rate, e.g] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

16. Encontrar TikTok Productos

Prompt: Examen TikTok Shop el rendimiento del producto para [product ID] dentro [target marketplace]. Uso [my TikTok Shop product preference] 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/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_tiktok_product_analytics

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": "tiktok-product-analytics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_product_analytics",
    "arguments": {
      "dateRange": "last30Day",
      "pageNumber": 1,
      "pageSize": 10,
      "productId": "1732505564636812173",
      "region": "US",
      "sortField": {}
    }
  }
}

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
`region`	`string`	opcional	TikTok comprar market region code, e.g., US. Si no se especifica, predetermina el servidor por defecto (normalmente US) Ejemplo: US
`dateRange`	`string`	opcional	Rango relativo de fecha, e.g. , Last7Day, last30Day Ejemplo: last30Day
`currency`	`string`	opcional	Código de moneda, e.g., USD
`language`	`string`	opcional	Lenguaje de retorno, e.g. zh-CN, en-US
`sortField`	`object`	opcional	Ordenar el objeto de especificación; omitido para usar el ranking predeterminado Ejemplo: {}
`category_ids`	`array`	opcional	Categoría ID lista filtro Ejemplo: []
`shop_id`	`string`	opcional	Tienda ID filtro
`creator_id`	`string`	opcional	Creador ID filtro
`video_id`	`string`	opcional	Productos de devolución asociados al vídeo especificado
`livestream_id`	`string`	opcional	Productos de retorno asociados con el flujo directo especificado
`revenue_range`	`string`	opcional	Ingresos / GMV filtro
`is_affiliate`	`string`	opcional	Filtro de afiliado: PUBLIC_PLAN o NON_AFFILIATE
`commission_rate`	`number`	opcional	Tasa de comisión de afiliados, e.g. 0.15
`is_tts_product`	`integer`	opcional	Filtro completo del producto: 1 o 0
`unit_price_range`	`string`	opcional	Filtro de rango de precio-unidad de producto
`pageNumber`	`integer`	opcional	Número de página, rango 1-5 Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, rango 5-100 Ejemplo: 10
`productId`	`string`	opcional	TikTok producto ID, e.g., 1729508370969629931 (formato de cuerda, para evitar la pérdida de precisión de entero grande), obtenible de la product_id en la respuesta de la categoría de producto Ejemplo: 1732505564636812173

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 o datos detallados; la respuesta real no regresa `total`
`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 ID (formato de cuerda para evitar la pérdida de gran precisión de entero), se puede utilizar como `productId` detalles de la consulta
`product_name`	`string`	opcional	Título del producto
`unit_price`	`number`	opcional	Precio unitario, la moneda depende de `region`, como US es USD
`sales_volumn`	`integer`	opcional	Volumen de ventas (unidades); nombre de campo `sales_volumn`, no `volume`
`revenue`	`number`	opcional	Total ventas / GMV, igual `video_revenue` + `live_revenue` + `showcase_revenue`
`video_revenue`	`number`	opcional	Ventas de canales de vídeo
`live_revenue`	`number`	opcional	Ventas de canales de transmisión en vivo
`showcase_revenue`	`number`	opcional	Window/display ventas de canales
`revenue_growth_rate`	`number`	opcional	Tasa de crecimiento de las ventas (porcentaje, e.g. `27.94` representa 27,94%)
`commission_rate`	`number`	opcional	Tasa de la Comisión, porcentaje directo, como `25.0` significa 25%, no puntos de base
`launch_date`	`string`	opcional	Fecha en los estantes`YYYY-MM-DD`)
`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

Examen TikTok Shop el rendimiento del producto. Uso del producto ID 1734020651102734110. Concéntrate en Tailandia.

Respuesta de ejemplo

En la muestra publicada, su nombre de producto reportado es AKCK consciente de que no es suficiente. Sus ingresos notificados son 2212535.2. El valor indicado de el volumen de ventas es 30211. 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": "1734020651102734110",
  "region": "TH",
  "currency": "THB",
  "dateRange": "last30Day",
  "pageNumber": 1,
  "pageSize": 5
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "sec_cate_id": "950792",
        "product_region": "th",
        "creator_number": 611,
        "video_revenue": 2203814.26,
        "sales_volumn": 30211,
        "video_number": 1970,
        "ter_cate_id": "951176",
        "unit_price": 73.24,
        "product_name": "AKCKแผ่นแปะสมุนไพรหอมระเหยจากพืช ช่วยผ่อนคลายจิตใจ สร้างบรรยากาศสบายก่อนนอน และบรรเทาความเจ็บปวดในยามค่ำคืน",
        "revenue": 2212535.2,
        "max_price": 201.73,
        "min_price": 84.47,
        "delivery_type": "local",
        "product_review_count": 9060,
        "product_id": "1734020651102734110",
        "pri_cate_id": "700645",
        "live_number": 222,
        "commission_rate": 11,
        "launch_date": "2026-01-16",
        "shopping_mall_revenue": 71.15,
        "product_description": [
          {
            "sub": [
              {
                "b": true,
                "t": "ฝ่ายบริการลูกค้า: หากคุณได้รับสินค้าที่เสียหาย จำนวนไม่ครบ หรือสินค้ามีตำหนิ โปรดติดต่อฝ่ายบริการลูกค้าของเราผ่านทางข้อความส่วนตัวใน TikTok ก่อนที่จะเขียนรีวิว และส่งรูปภาพของปัญหามาด้วย เราจะแก้ไขปัญหาให้คุณทันที!"
              }
            ],
            "text": "ฝ่ายบริการลูกค้า: หากคุณได้รับสินค้าที่เสียหาย จำนวนไม่ครบ หรือสินค้ามีตำหนิ โปรดติดต่อฝ่ายบริการลูกค้าของเราผ่านทางข้อความส่วนตัวใน TikTok ก่อนที่จะเขียนรีวิว และส่งรูปภาพของปัญหามาด้วย เราจะแก้ไขปัญหาให้คุณทันที!",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "วิธีใช้:"
              }
            ],
            "text": "วิธีใช้:",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "1. ลอกแผ่นฟิล์มออก"
              }
            ],
            "text": "1. ลอกแผ่นฟิล์มออก",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "2. ทาผลิตภัณฑ์ลงบนร่างกายของคุณ"
              }
            ],
            "text": "2. ทาผลิตภัณฑ์ลงบนร่างกายของคุณ",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "3. ลอกออกหลังจากตื่นนอน (ประมาณ 8-12 ชั่วโมง)"
              }
            ],
            "text": "3. ลอกออกหลังจากตื่นนอน (ประมาณ 8-12 ชั่วโมง)",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "4. แนะนำว่าไม่ควรใช้เกิน 48 ชั่วโมง มิเช่นนั้นผิวหนังอาจรับไม่ไหว (แตกต่างกันไปในแต่ละบุคคล)"
              }
            ],
            "text": "4. แนะนำว่าไม่ควรใช้เกิน 48 ชั่วโมง มิเช่นนั้นผิวหนังอาจรับไม่ไหว (แตกต่างกันไปในแต่ละบุคคล)",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "ชื่อผลิตภัณฑ์: แผ่นแปะช่วยนอนหลับ สรรพคุณ: ช่วยในการนอนหลับ จำนวน: 12 ชิ้น วัสดุ: ผ้าไม่ทอ อายุการใช้งาน: 3 ปี การเก็บรักษา: เก็บในที่แห้งและเย็น"
              }
            ],
            "text": "ชื่อผลิตภัณฑ์: แผ่นแปะช่วยนอนหลับ สรรพคุณ: ช่วยในการนอนหลับ จำนวน: 12 ชิ้น วัสดุ: ผ้าไม่ทอ อายุการใช้งาน: 3 ปี การเก็บรักษา: เก็บในที่แห้งและเย็น",
            "type": "text"
          },
          {
            "image": {
              "remove_gap": "false",
              "url_list": [
                "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
                "https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
              ],
              "width": 1728,
              "uri": "tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00",
              "height": 2304
            },
            "type": "image"
          },
          {
            "image": {
              "remove_gap": "false",
              "url_list": [
                "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
                "https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
              ],
              "width": 1728,
              "uri": "tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a",
              "height": 2304
            },
            "type": "image"
          },
          {
            "image": {
              "remove_gap": "false",
              "url_list": [
                "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
                "https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
              ],
              "width": 1728,
              "uri": "tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9",
              "height": 2304
            },
            "type": "image"
          }
        ],
        "product_shop_id": "7494255174154028830",
        "live_revenue": 8649.8
      }
    ]
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos