Inteligencia de TikTok KD
API de clasificaciones de tiendas de TikTok MCP
Rank TikTok Shops para una región seleccionada y rango de fechas para comparar el rendimiento disponible y descubrir tiendas que valen la pena investigar.
Prompts y casos de uso de API de clasificaciones 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. Revisa the returned TikTok Shop rankings
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en un idioma seleccionado
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop ID] dentro [target marketplace]. Volver las descripciones disponibles en [my preferred supported language], manteniendo los identificadores sin cambios.
3. Investigación en una moneda seleccionada
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop 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.
4. Revise un período específico de presentación de informes
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop 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: Consulta la clasificación de tiendas de TikTok devuelta para [shop 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: Consulta la clasificación de tiendas de TikTok devuelta para [shop 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 tiendas dentro de un GMV Rango
Prompt: Consulta la clasificación de tiendas de TikTok para [shop ID] dentro [target marketplace], con importes de transacción en o más [minimum GMV] y categorías inferiores [maximum GMV]. Mantenga el alcance de clasificación devuelto visible.
8. Resultados estrechos por categoría ID Filtro de Lista
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop ID] dentro [target marketplace]. Uso [my selected category id list filtering] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
9. Seleccione tiendas de marca o minoristas
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop ID] dentro [target marketplace]. Concéntrate en [brand stores or retailers] y comparar sólo el tipo de tienda seleccionado. Resumir sólo los registros devueltos.
10. Resultados estrechos por categoría ID
Prompt: Consulta la clasificación de tiendas de TikTok devuelta para [shop ID] dentro [target marketplace]. Uso [my selected category id] 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/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_data_kd_shop_rankhttps://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": "data-kd-shop-rank-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_kd_shop_rank",
"arguments": {
"currency": "USD",
"dateRange": "last7Day",
"pageNumber": 1,
"pageSize": 10,
"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 |
|---|---|---|---|
category_id | string | opcional | Categoría ID, que puede limitar aún más las dimensiones de la categoría devuelta |
category_ids | array | opcional | Categoría ID lista de filtración; después de especificar, devolver el importe de transacción bajo la categoría correspondiente |
category_ids[] | string | obligatorio | Categoría ID lista de filtración; después de especificar, devolver el importe de transacción bajo la categoría correspondiente |
currency | string | opcional | Unidad de moneda, como `USD`; longitud máxima 1000 |
dateRange | string | opcional | Rango de tiempo, como `last7Day`, `last30Day`; longitud máxima 1000 |
language | string | opcional | Lenguaje de retorno, como `zh-CN`, `en-US`; longitud máxima 1000 |
pageNumber | integer | opcional | Número de página, valor 1-5; rendimientos fuera de rango `errcode 501` |
pageSize | integer | opcional | Cantidad por página, valor 5-100 |
region | string | opcional | Region/market código, como `US`; longitud máxima 1000 |
revenue_range | string | opcional | Cantidad de transacción / GMV rango, cerrado izquierdo y abierto derecho |
shopId | string | obligatorio | TikTok Shop única ID (estring, to avoid loss of large integer accuracy), such as `7495514739648989419`, que se puede obtener de `shop_id` en la lista |
shop_type | string | opcional | Tipo de tienda: `BRAND` (marca) o `RETAILER` (retailer) |
sortField | object | opcional | Condiciones de clasificación; cuando no se clasifica, pase un objeto vacío `{}` |
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 de tiendas o array de detalles de 1 elemento |
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 |
rank | integer | opcional | Clasificación, 1 es el más alto |
shop_name | string | opcional | Nombre de la tienda |
shop_id | string | opcional | Tienda única ID (estring, to avoid loss of large integer accuracy) |
shop_type | string | opcional | Tipo de tienda, como `BRAND` |
revenue | number | opcional | Total sales/GMV solicitado `currency` moneda |
sales_volumn | integer | opcional | Volumen de ventas, campo deletreado `volumn` |
on_sell_product_count | integer | opcional | Número de artículos en venta |
unit_price | number | opcional | Precio unitario solicitado `currency` moneda |
revenue_growth_rate | number | opcional | Tasa de crecimiento de las ventas (%), puede ser positiva o negativa |
self_promotion_revenue | number | opcional | Auto-operated/self-promoted ventas |
affiliate_revenue | number | opcional | Ventas de distribución principal |
shopping_mall_revenue | number | opcional | Ventas comerciales |
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 |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
Revisa the returned TikTok rankings de tiendas. Centrarse en el US.
Pasos sugeridos
Proporcionar los insumos para esta tarea de investigación y revisar los registros devueltos en la vista de resultados documentada. La documentación disponible no establece una respuesta de ejemplo coincidente, por lo que no se reclama aquí ningún resultado, ejecución métrica o exitosa.
Sobre esta muestra: La ruta se llama como una herramienta de clasificación, pero su actual MCP schema requiere una tienda individual ID mientras la solicitud publicada lo omite. Esta es una explicación de flujo de trabajo hasta que se resuelva ese conflicto; no se reclama ninguna respuesta válida de clasificación.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
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
No hay un ejemplo verificado de solicitud MCP. Consulta Integración y los requisitos documentados antes de preparar una llamada.
Formato de respuesta MCP
Este flujo de trabajo no afirma haber obtenido un resultado de la API. No hay un ejemplo de respuesta verificado; consulta Parámetros y respuesta para ver la estructura documentada.