Inteligencia de TikTok ET
API de búsqueda de vendedores de TikTok MCP
Encontrar TikTok Vendedores por región y opciones disponibles para clasificar las tiendas de investigación e identificar competidores relevantes.
Prompts y casos de uso de API de búsqueda de vendedores 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. Descubre TikTok vendedores en un mercado
Prompt: Descubre TikTok vendedores en un mercado para [category 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: Descubre TikTok vendedores en un mercado para [category 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. Priorizar los resultados para la revisión
Prompt: Descubre TikTok vendedores en un mercado para [category 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.
4. Buscar coincidencias por categoría secundaria de tiendas ID
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Limitación de los resultados [my chosen store secondary category id range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
5. Encontrar coincidencias por la categoría de tercer nivel ID De la tienda
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Limitación de los resultados [my chosen the third-level category id of the store range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
6. Encontrar coincidencias por GMV Proyección en los últimos 30 días
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Limitación de los resultados [my chosen gmv screening in the past 30 days range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
7. Encontrar coincidencias por primera fecha observada
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Limitación de los resultados [my chosen first observed date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
8. Encontrar tiendas de cultivo o declinación
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Centrarse en las tiendas con [stable, increasing or declining] ventas durante la ventana de tendencia documentada de siete días. Resumir sólo los registros devueltos.
9. Encontrar tiendas locales o cruzadas
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Concéntrate en [local stores or cross-border stores]. Según mi informe de investigación. Resumir sólo los registros devueltos.
10. Elija un canal de venta de contenidos
Prompt: Descubre TikTok vendedores en un mercado para [category ID] dentro [target marketplace]. Reducir los resultados [video or livestream] promoción, según mi informe de investigación. Resumir sólo los registros 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/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_et_list_sellerhttps://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-et-list-seller-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_list_seller",
"arguments": {
"pageNum": 1,
"pageSize": 20,
"region": "US",
"sellerSortField": 2,
"sortType": 1
}
}
}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 |
|---|---|---|---|
region | string | obligatorio | área. Valores opcionales: US (Estados Unidos) ID (Indonesia), TH (Tailandia), PH (Filipinas), MY (Malasia), VN (Vietnam), GB (UK), MX (México) SG (Singapur), SA (Arabia Saudita), BR (Brasil), ES (España), JP (Japón), DE (Alemania), IT (Italia) FR (Francia) |
categoryId | string | opcional | Categoría de nivel de tiendas IDLongitud máxima 1000 |
categoryL2Id | string | opcional | Categoría secundaria de tiendas IDLongitud máxima 1000 |
categoryL3Id | string | opcional | La categoría de tercer nivel ID de la tienda. Longitud máxima 1000 |
minTotalSaleGmv30dAmt | number | opcional | GMV proyección en los últimos 30 días (valor mínimo) |
maxTotalSaleGmv30dAmt | number | opcional | GMV filtrado en los últimos 30 días (valor máximo) |
salesTrendFlag | integer | opcional | Tendencia de ventas en los últimos 7 días: 0=estable, 1=aumento, 2=declining |
fromFlag | integer | opcional | Fuente de la tienda: 1=local store, 2=cross-border store |
salesFlag | integer | opcional | Main delivery methods: 1=video, 2=live broadcast |
minFirstCrawlDt | integer | opcional | Filtro de tiempo estimado de estante (valor mínimo), yyyyMMdd formato (por ejemplo, 20240101 representa 2024-01-01) |
maxFirstCrawlDt | integer | opcional | Filtro de tiempo estimado de estante (valor máximo), yyyyMMdd formato |
sellerSortField | integer | opcional | Campos de clasificación: 1=ventas totales (total_sale_cnt), 2 = ventas totales (total_sale_gmv_amt), 3=precio del precio del producto SKU en la tiendaspu_avg_price) Ejemplo: 2 |
sortType | integer | opcional | Método de clasificación: 0= orden ascendente (asc), 1= orden descendente (desc) Ejemplo: 1 |
pageNum | integer | opcional | Número de página de Paginación, a partir de 1 Ejemplo: 1 |
pageSize | integer | opcional | Número de artículos por página. **Debe ser un múltiplo de 10, el máximo es 100**; el límite superior de una sola página en la interfaz oficial es 10, internamente es 10 después de múltiples tiradas por página y luego fusionado Ejemplo: 50 |
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 comercial, 200 indica éxito (ver código de error abajo para detalles) |
errmsg | string | opcional | Descripción del estado empresarial |
total | integer | opcional | Número de registros |
sellers | array | opcional | Lista de tiendas (ver campos de tiendas abajo para más detalles) |
columns | array | opcional | Rendered columns |
type | string | opcional | Estilo de retroceso |
costToken | integer | opcional | Consume token |
sellerId | string | opcional | Store ID |
sellerName | string | opcional | Nombre de la tienda |
sellerLink | string | opcional | Enlace de la tienda |
coverUrl | string | opcional | Dirección de cubierta de almacén |
region | string | opcional | zona |
categoryId | string | opcional | Clasificación de primer nivel ID |
categoryL2Id | string | opcional | Clasificación secundaria ID |
categoryL3Id | string | opcional | Clasificación de tercer nivel ID |
totalSaleCnt | integer | opcional | ventas totales |
totalSale1dCnt | integer | opcional | Volumen de ventas en el último día (incremental) |
totalSale7dCnt | integer | opcional | Volumen de ventas en los últimos 7 días (incremental) |
totalSale30dCnt | integer | opcional | Volumen de ventas en los últimos 30 días (incremental) |
totalSale90dCnt | integer | opcional | Volumen de ventas en los últimos 90 días (incremental) |
totalSaleGmvAmt | number | opcional | ventas totales |
totalSaleGmv1dAmt | number | opcional | Ventas en el último día (incremental) |
totalSaleGmv7dAmt | number | opcional | Ventas en los últimos 7 días (incremental) |
totalSaleGmv30dAmt | number | opcional | Ventas en los últimos 30 días (incremental) |
totalSaleGmv90dAmt | number | opcional | Ventas en los últimos 90 días (incremental) |
followersCount | integer | opcional | Número de fans |
rating | number | opcional | Valoración |
reviewCount | integer | opcional | Número de opiniones |
positiveFeedbackRate | number | opcional | Valoración positiva |
responseRate | number | opcional | Tasa de respuesta |
deliveryRate | integer | opcional | Tasa de entrega |
totalProductCnt | integer | opcional | Número histórico de artículos en la tienda (incluyendo la eliminación de estantes) |
totalCrawlProductCnt | integer | opcional | Número de artículos en la tienda |
spuAvgPrice | number | opcional | Precio medio del producto SKU en la tienda |
minPrice | integer | opcional | precio más bajo |
maxPrice | integer | opcional | precio más alto |
totalIflCnt | integer | opcional | Número total de personas que transportan bienes |
totalVideoCnt | integer | opcional | Número total de vídeos entregados |
totalLiveCnt | integer | opcional | Total de emisiones en directo |
salesFlagText | string | opcional | Principales métodos de ejecución |
salesTrendFlagText | string | opcional | tendencias de las ventas |
shopIdentityLabel | string | opcional | tienda logo |
shopTypeText | string | opcional | ¿Es una tienda de marcas? |
fromFlagText | string | opcional | Identificación transfronteriza |
productCategoryList | string | opcional | Clasificación de productos |
mostProductCategoryList | string | opcional | TOP1 clasificación de productos |
firstCrawlDt | integer | opcional | Tiempo estimado de liberación, yyyyMMdd formato (por ejemplo, 20240101 representa 2024-01-01) |
userId | string | opcional | Maestro UID |
sourceType | string | opcional | Fuente de producto |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Descubre TikTok vendedores en un mercado. Centrarse en el US.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra la calificación: 4.5; vendedor id: ejemplo-sellerId. Estas cifras describen sólo el registro mostrado. A partir de este ejemplo, no se pueden calcular las medidas que faltan.
Sobre esta muestra: Ejemplo ilustrativo con registros ficticios; no procede de una llamada real. Los identificadores, precios y recuentos son datos de demostració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 ilustrativo con datos ficticios, no 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": "data-et-list-seller-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_list_seller",
"arguments": {
"pageNum": 1,
"pageSize": 20,
"region": "US",
"sellerSortField": 2,
"sortType": 1
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "data-et-list-seller-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"sellerId\":\"example-sellerId\",\"rating\":4.5}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"sellerId": "example-sellerId",
"rating": 4.5
}
},
"isError": false
}
}