Inteligencia de TikTok KD

API de análisis de tiendas de TikTok MCP

Consulta clasificaciones y detalles de tiendas de TikTok Shop, incluidos ventas por región, ingresos, productos, canales y colaboraciones con creadores. Disponible mediante API REST 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 tiendas 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. Consultar el GMV de una tienda

Prompt: Muestra el GMV, el volumen de ventas y el número de productos a la venta de la tienda de TikTok Shop [SHOP_ID] en [REGION] durante los últimos 30 días. Usa [CURRENCY] e indica si falta alguna cifra.

2. Consulta las ventas por canal

Prompt: Para la tienda de TikTok Shop [SHOP_ID] en [REGION], muestra las ventas de promoción propia, afiliados y el centro comercial durante los últimos 30 días en [CURRENCY]. Compara los importes disponibles sin suponer que suman el GMV total.

3. Verificar creador y actividad de contenido

Prompt: Muestra el número de creadores, vídeos y transmisiones en directo asociados con la tienda de TikTok Shop [SHOP_ID] en [REGION] durante los últimos 30 días, junto con las ventas de afiliados en [CURRENCY]. No atribuyas las ventas a esas actividades sin datos que respalden la relación.

4. Ventas de tienda por categoría

Prompt: Muestra las ventas de la tienda de TikTok Shop [SHOP_ID] en la categoría [CATEGORY_ID] y la región [REGION] durante los últimos 30 días. Usa [CURRENCY] y resume las cifras disponibles para esa categoría.

5. Obtenga un informe de la tienda en inglés

Prompt: Muestra un informe de la tienda de TikTok Shop [SHOP_ID] en [REGION] para los últimos 30 días, con los nombres y las descripciones en inglés y las cifras de ventas en [CURRENCY]. Conserva los ID de tienda e indica qué información no está disponible en inglés.

6. Comparar tienda GMV

Prompt: Compara las tiendas de TikTok Shop [SHOP_A_ID] y [SHOP_B_ID] en [REGION] durante los últimos 30 días. Consulta cada tienda por separado, presenta el GMV y el volumen de ventas en paralelo en [CURRENCY] y calcula la diferencia cuando dispongas de ambas cifras.

7. Compara las ventas de 7 días y 30 días

Prompt: Consulta la tienda de TikTok Shop [SHOP_ID] en [REGION] para los últimos 7 y 30 días, usando [CURRENCY]. Compara las ventas medias diarias de ambas consultas. Explica que los períodos se solapan y que la comparación no representa un crecimiento intermensual.

Qué debes proporcionar

Proveer la tienda ID, mercado y moneda para la investigación de tiendas, o elegir un mercado para el descubrimiento de la tabla de clasificación. Use una categoría válida existente ID para la investigación específica de categoría.

Los ejemplos abarcan opciones documentadas. Las cifras desaparecidas siguen sin estar disponibles, y los rankings describen la muestra devuelta en lugar de cada tienda en el mercado.

El descubrimiento de tableros de mando y los filtros avanzados de categoría o de ingresos están a la espera de la aclaración de sus definiciones de entrada y respuesta publicadas. Estos ejemplos se han retenido; los ejemplos de tienda-detalles anteriores no establecen la cobertura completa del filtro o de la tabla.

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_shop_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-shop-analytics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_shop_analytics",
    "arguments": {
      "dateRange": "last30Day",
      "pageNumber": 1,
      "pageSize": 10,
      "region": "US",
      "shopId": "7496162162184128712",
      "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	Region/market código, e.g., US. Longitud máxima 1000 Ejemplo: US
`dateRange`	`string`	opcional	Rango de tiempo, e.g., last7Day (los últimos 7 días), last30Day (los últimos 30 días). Longitud máxima 1000 Ejemplo: last30Day
`pageNumber`	`integer`	opcional	Número de página, rango de valor 1-5 (desde el rango devuelve errcode 501) Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, rango de valor 5-100 Ejemplo: 10
`language`	`string`	opcional	Lenguaje de retorno, e.g. zh-CN, en-US. Longitud máxima 1000
`currency`	`string`	opcional	Unidad de moneda e.g., USD. Longitud máxima 1000
`sortField`	`object`	opcional	Clasificar criterios; pasar un objeto vacío {} para el orden de rango predeterminado cuando no ordenar Ejemplo: {}
`category_ids`	`array`	opcional	Categoría ID filtro de lista; los resultados utilizan la dimensión de categoría seleccionada Ejemplo: []
`revenue_range`	`string`	opcional	Ingresos / GMV filtro
`shop_type`	`string`	opcional	Filtro tipo tienda: BRAND o RETAILER
`category_id`	`string`	opcional	Dimensión opcional de ID de categoría
`shopId`	`string`	opcional	TikTok Shop única ID (estring, to avoid large integer accuracy loss), e.g., 7495514739648989419. Obtainable from the shop_id campo en el campo de respuesta de rango de tienda Ejemplo: 7496162162184128712

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 la tienda, fijados a 1 matriz de elementos cuando tenga éxito
`costToken`	`integer`	opcional	El token de deducción para esta llamada se fija a `14000`
`errmsg`	`string`	opcional	Mensaje de estado, `ok` sobre el éxito
`shop_id`	`string`	opcional	Tienda única ID (estring, to avoid loss of large integer accuracy)
`shop_name`	`string`	opcional	Nombre de la tienda
`seller_type`	`string`	opcional	Store/seller tipo, como `BRAND`; uso `seller_type` para detalles, no `shop_type`
`region`	`string`	opcional	Region/market tales como `US`
`revenue`	`number`	opcional	Total sales/GMV solicitado `currency` moneda
`sales_volumn`	`integer`	opcional	Volumen de ventas, campo deletreado `volumn`
`product_number`	`integer`	opcional	Número de artículos en venta
`unit_price`	`number`	opcional	Precio unitario solicitado `currency` moneda
`self_account_revenue`	`number`	opcional	Auto-operated/self-broadcast ventas autopromovidas; uso `self_account_revenue` para más detalles
`affiliate_revenue`	`number`	opcional	Ventas de distribución principal
`shoppingmall_revenue`	`number`	opcional	Ventas comerciales; no hay subrayación entre `shopping` y `mall` en el nombre de campo detallado
`creator_number`	`integer`	opcional	Número de colaboraciones con expertos
`video_number`	`integer`	opcional	Número de vídeos asociados
`live_number`	`integer`	opcional	Número de transmisiones en directo asociadas

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

¿Qué tienda tiene el GMV más alto entre las tiendas del Reino Unido devueltas en la muestra?

Respuesta de ejemplo

En la muestra publicada, medicube UK presenta el GMV más alto entre las tiendas devueltas: 2.181.457,01. Su volumen de ventas declarado es de 92.351 unidades y sus ventas de afiliados ascienden a 2.093.266,66.

Sobre esta muestra: La comparación solo abarca las tiendas devueltas, no todo el mercado del Reino Unido. La solicitud publicada no indica la moneda ni el período; por tanto, estas cifras no deben presentarse como ventas actuales ni como datos confirmados de los últimos 30 días.

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

{
  "region": "GB"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "shop_id": "7496304415144774132",
        "revenue_growth_rate": 53.85,
        "revenue": 2181457.01,
        "sales_volumn": 92351,
        "on_sell_product_count": 114,
        "self_promotion_revenue": 54670.12,
        "affiliate_revenue": 2093266.66,
        "shop_type": "BRAND",
        "rank": 1,
        "shop_name": "medicube UK",
        "unit_price": 23.62,
        "shopping_mall_revenue": 33520.24
      },
      {
        "shop_id": "7494608413204122336",
        "revenue_growth_rate": 158.15,
        "revenue": 1307233.31,
        "sales_volumn": 58658,
        "on_sell_product_count": 387,
        "self_promotion_revenue": 251907.17,
        "affiliate_revenue": 1036752.04,
        "shop_type": "RETAILER",
        "rank": 2,
        "shop_name": "plmakeupacademy",
        "unit_price": 22.29,
        "shopping_mall_revenue": 18574.1
      },
      {
        "shop_id": "7494683660387060475",
        "revenue_growth_rate": 305.21,
        "revenue": 1049177.76,
        "sales_volumn": 6130,
        "on_sell_product_count": 88,
        "self_promotion_revenue": 27701.96,
        "affiliate_revenue": 867811.95,
        "shop_type": "BRAND",
        "rank": 3,
        "shop_name": "Ninja UK",
        "unit_price": 171.15,
        "shopping_mall_revenue": 153663.85
      },
      {
        "shop_id": "7494089321652061362",
        "revenue_growth_rate": 153.11,
        "revenue": 612321.08,
        "sales_volumn": 18808,
        "on_sell_product_count": 122,
        "self_promotion_revenue": 32515.58,
        "affiliate_revenue": 575583.81,
        "shop_type": "BRAND",
        "rank": 4,
        "shop_name": "Dr.melaxin UK",
        "unit_price": 32.56,
        "shopping_mall_revenue": 4221.69
      },
      {
        "shop_id": "7496047005540322107",
        "revenue_growth_rate": 110.67,
        "revenue": 596757.51,
        "sales_volumn": 3547,
        "on_sell_product_count": 71,
        "self_promotion_revenue": 5609.01,
        "affiliate_revenue": 439579.04,
        "shop_type": "BRAND",
        "rank": 5,
        "shop_name": "Shark UK",
        "unit_price": 168.24,
        "shopping_mall_revenue": 151569.46
      },
      {
        "shop_id": "7495918771470502637",
        "revenue_growth_rate": 214.94,
        "revenue": 592083.13,
        "sales_volumn": 18728,
        "on_sell_product_count": 75,
        "self_promotion_revenue": 77499.23,
        "affiliate_revenue": 512364.06,
        "shop_type": "BRAND",
        "rank": 6,
        "shop_name": "Halara UK Shop",
        "unit_price": 31.61,
        "shopping_mall_revenue": 2219.84
      },
      {
        "shop_id": "7494645643613669598",
        "revenue_growth_rate": 1042.72,
        "revenue": 540502.2,
        "sales_volumn": 29410,
        "on_sell_product_count": 45,
        "self_promotion_revenue": 60957.5,
        "affiliate_revenue": 478959.64,
        "shop_type": "BRAND",
        "rank": 7,
        "shop_name": "Wonderskin UK",
        "unit_price": 18.38,
        "shopping_mall_revenue": 585.06
      },
      {
        "shop_id": "7496099247909472498",
        "revenue_growth_rate": 92.69,
        "revenue": 515216.63,
        "sales_volumn": 14477,
        "on_sell_product_count": 1341,
        "self_promotion_revenue": 13516.62,
        "affiliate_revenue": 468165.7,
        "shop_type": "RETAILER",
        "rank": 8,
        "shop_name": "halara.wardrobe",
        "unit_price": 35.59,
        "shopping_mall_revenue": 33534.31
      },
      {
        "shop_id": "7495800853072349547",
        "revenue_growth_rate": 345.1,
        "revenue": 401816.95,
        "sales_volumn": 13395,
        "on_sell_product_count": 94,
        "self_promotion_revenue": 63732.18,
        "affiliate_revenue": 333662.52,
        "shop_type": "BRAND",
        "rank": 9,
        "shop_name": "BellaVita UK",
        "unit_price": 30,
        "shopping_mall_revenue": 4422.26
      },
      {
        "shop_id": "7495314598416255768",
        "revenue_growth_rate": 112.85,
        "revenue": 335972.56,
        "sales_volumn": 2395,
        "on_sell_product_count": 52,
        "self_promotion_revenue": 0,
        "affiliate_revenue": 283692.78,
        "shop_type": "BRAND",
        "rank": 10,
        "shop_name": "Vax UK",
        "unit_price": 140.28,
        "shopping_mall_revenue": 52279.78
      },
      {
        "shop_id": "7495613047709207418",
        "revenue_growth_rate": 659.83,
        "revenue": 323096.38,
        "sales_volumn": 8890,
        "on_sell_product_count": 280,
        "self_promotion_revenue": 7338.77,
        "affiliate_revenue": 311978.16,
        "shop_type": "BRAND",
        "rank": 11,
        "shop_name": "Keplin",
        "unit_price": 36.34,
        "shopping_mall_revenue": 3779.46
      },
      {
        "shop_id": "7494083467033281878",
        "revenue_growth_rate": 322.85,
        "revenue": 320405.01,
        "sales_volumn": 14254,
        "on_sell_product_count": 1200,
        "self_promotion_revenue": 1804.67,
        "affiliate_revenue": 310682.64,
        "shop_type": "BRAND",
        "rank": 12,
        "shop_name": "Trespass UK",
        "unit_price": 22.48,
        "shopping_mall_revenue": 7917.7
      },
      {
        "shop_id": "7496019364959325021",
        "revenue_growth_rate": 251.23,
        "revenue": 281996.81,
        "sales_volumn": 4405,
        "on_sell_product_count": 24,
        "self_promotion_revenue": 28115.46,
        "affiliate_revenue": 227752.65,
        "shop_type": "RETAILER",
        "rank": 13,
        "shop_name": "TYMO-BEAUTY UK",
        "unit_price": 64.02,
        "shopping_mall_revenue": 26128.69
      },
      {
        "shop_id": "7494102303840373619",
        "revenue_growth_rate": -1.64,
        "revenue": 277435.27,
        "sales_volumn": 2786,
        "on_sell_product_count": 70,
        "self_promotion_revenue": 95.76,
        "affiliate_revenue": 269248.02,
        "shop_type": "BRAND",
        "rank": 14,
        "shop_name": "Anker UK",
        "unit_price": 99.58,
        "shopping_mall_revenue": 8091.5
      },
      {
        "shop_id": "7494477044510853251",
        "revenue_growth_rate": 56.25,
        "revenue": 268870.72,
        "sales_volumn": 15130,
        "on_sell_product_count": 551,
        "self_promotion_revenue": 840.08,
        "affiliate_revenue": 256560.76,
        "shop_type": "BRAND",
        "rank": 15,
        "shop_name": "Onlinehomeshop",
        "unit_price": 17.77,
        "shopping_mall_revenue": 11469.87
      },
      {
        "shop_id": "7494548121986763046",
        "revenue_growth_rate": 74.85,
        "revenue": 267663.3,
        "sales_volumn": 15783,
        "on_sell_product_count": 80,
        "self_promotion_revenue": 92690.92,
        "affiliate_revenue": 172869.87,
        "shop_type": "BRAND",
        "rank": 16,
        "shop_name": "madebymitchell",
        "unit_price": 16.96,
        "shopping_mall_revenue": 2102.51
      },
      {
        "shop_id": "7496052564698762045",
        "revenue_growth_rate": 296.76,
        "revenue": 259946.77,
        "sales_volumn": 6001,
        "on_sell_product_count": 1003,
        "self_promotion_revenue": 33951.99,
        "affiliate_revenue": 207666.39,
        "shop_type": "BRAND",
        "rank": 17,
        "shop_name": "QVC UK",
        "unit_price": 43.32,
        "shopping_mall_revenue": 18328.4
      },
      {
        "shop_id": "7495337003120626279",
        "revenue_growth_rate": 547.56,
        "revenue": 253964.84,
        "sales_volumn": 14651,
        "on_sell_product_count": 41,
        "self_promotion_revenue": 16044.11,
        "affiliate_revenue": 237549.59,
        "shop_type": "BRAND",
        "rank": 18,
        "shop_name": "Nutrition Geeks",
        "unit_price": 17.33,
        "shopping_mall_revenue": 371.14
      },
      {
        "shop_id": "7495694615892363469",
        "revenue_growth_rate": -18.3,
        "revenue": 245261.37,
        "sales_volumn": 7861,
        "on_sell_product_count": 4792,
        "self_promotion_revenue": 17634.42,
        "affiliate_revenue": 205049.97,
        "shop_type": "BRAND",
        "rank": 19,
        "shop_name": "EGO FASHION",
        "unit_price": 31.2,
        "shopping_mall_revenue": 22576.99
      },
      {
        "shop_id": "7494684671938037907",
        "revenue_growth_rate": 582.49,
        "revenue": 242003.07,
        "sales_volumn": 7947,
        "on_sell_product_count": 41,
        "self_promotion_revenue": 0,
        "affiliate_revenue": 240747.73,
        "shop_type": "BRAND",
        "rank": 20,
        "shop_name": "Remington UK",
        "unit_price": 30.45,
        "shopping_mall_revenue": 1255.34
      }
    ]
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos