Inteligencia comercial de TikTok CJ
API de búsqueda de tiendas de TikTok MCP
Búsqueda TikTok Shops para encontrar vendedores competidores. Llama a la TikTok Shop Buscar API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de búsqueda 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. Búsqueda TikTok Shops para encontrar vendedores competidores
Prompt: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] 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: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] 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: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] 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. La métrica documentada es gmv 7d; elige orden ascendente o descendente.
4. Encontrar coincidencias por Shop Rating
Prompt: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen shop rating range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
5. Encontrar coincidencias por Sold7D
Prompt: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen sold7d range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
6. Encontrar coincidencias por GMV7D
Prompt: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen gmv7d range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
7. Resultados estrechos por categoría de producto ID
Prompt: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] dentro [target marketplace]. Uso [my selected product category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
8. Elija un tipo de vendedor
Prompt: Búsqueda TikTok Shops para encontrar vendedores competidores para [search phrase] dentro [target marketplace]. Uso [my selected seller type] y mantener la clasificación del vendedor visible en los resultados. 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_chuhaijiang_tiktok_shop_searchhttps://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": "chuhaijiang-tiktok-shop-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_shop_search",
"arguments": {
"country": "us",
"keyword": "beauty",
"minRating": 4,
"pageSize": 3
}
}
}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 |
|---|---|---|---|
country | string | obligatorio | Maleta inferior TikTok Código de mercado. Ejemplo: us |
page | integer | opcional | Número de página, empezando en 1. Ejemplo: 1 |
pageSize | integer | opcional | Registros máximos por página. Ejemplo: 3 |
keyword | string | opcional | Busca una palabra clave. Ejemplo: beauty |
category | string | opcional | Categoría de productos ID. |
sellerType | string | opcional | Tipo de vendedor compatible con el proveedor. |
sort | string | opcional | Proveedor de campo y dirección (campo:asc o campo:desc). Ejemplo: gmv_7d:desc |
minRating | number | opcional | Nota mínima de la tienda. Ejemplo: 4 |
maxRating | number | opcional | Valoración máxima de la tienda. |
minSold7d | number | opcional | Ventas mínimas de 7 días. |
maxSold7d | number | opcional | Máximas ventas de 7 días. |
minGmv7d | number | opcional | Mínimo 7 días GMV. |
maxGmv7d | number | opcional | Máximo 7 días GMV. |
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 tiendas está en `data.items[]`, número total es `data.total_count` |
id | string | opcional | Store ID, se puede pasar a detalles y puntos finales de asociación |
shop_sold_count_for_last_7_days | number | opcional | Volumen de ventas en los últimos 7 días |
total_related_creator_count | number | opcional | Número acumulado de personas conectadas |
seller_business_info | array<string> | opcional | Información de la entidad empresarial |
sold_count_trend | array<object> | opcional | Puntos de tendencia de ventas, incluidos `timestamp`, `value` |
id | string | opcional | Store ID |
shopname | string | opcional | Nombre de la tienda |
region | string | opcional | shop market |
shoprating | number | opcional | Categoría de tiendas |
shopmaincategory | string | opcional | Clasificación principal de las empresas |
shopproductcount | number | opcional | Número de artículos |
shoptotalsoldcount | number | opcional | Ventas acumuladas |
shoptotalgmv | object | opcional | Cumulative GMV |
shopsoldcountforlast7days | number | opcional | Volumen de ventas en los últimos 7 días |
shopgmvforlast7days | object | opcional | GMV en los últimos 7 días |
totalrelatedcreatorcount | number | opcional | Número acumulado de personas conectadas |
sellerbusinessinfo | array | opcional | Información de la entidad empresarial |
soldcounttrend | array<object> | opcional | tendencias de las ventas |
shop_rating | number | opcional | Categoría de tiendas |
shop_total_gmv | object | opcional | Cumulative GMV |
shop_main_category | string | opcional | Clasificación principal de las empresas |
business_info | array | opcional | Entidad empresarial |
seller_avatar | object | opcional | Vendedor avatar |
creator_role | integer | opcional | Función de la contabilidad |
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
Búsqueda TikTok Shops para encontrar vendedores competidores. Use “perfume”. Concéntrate en Vietnam.
Respuesta de ejemplo
En la muestra publicada, el primer registro que se muestra es “Công ty Công tí Công pháisn Charme Perfume”. Su calificación de tienda reportada es 3.9. Su recuento total de creadores relacionado con el informe es 501. 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
{
"country": "vn",
"keyword": "perfume",
"page": 1,
"pageSize": 10,
"sort": "gmv_7d:desc"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": {
"total_count": 472,
"items": [
{
"shop_rating": 3.9,
"shop_total_gmv": {
"unit": "VN",
"value": 223904334719.94278
},
"total_related_creator_count": 501,
"shop_product_count": 50,
"shop_total_sold_count": 270665,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 122950089413.54001
},
"shop_main_category": "601450",
"id": "7494778581356677369",
"region": "VN",
"shop_name": "Công ty Cổ phần Charme Perfume",
"sold_count_trend": [
{
"value": 265,
"timestamp": "1789257600000"
},
{
"value": 56,
"timestamp": "1789344000000"
},
{
"value": 142,
"timestamp": "1789430400000"
},
{
"value": 0,
"timestamp": "1789516800000"
},
{
"value": 41,
"timestamp": "1789603200000"
},
{
"value": 0,
"timestamp": "1789689600000"
},
{
"value": 0,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 504
},
{
"shop_rating": 4.4,
"shop_total_gmv": {
"unit": "VN",
"value": 569256790660.766
},
"total_related_creator_count": 1383,
"shop_product_count": 874,
"shop_total_sold_count": 1019414,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 70945345214.28
},
"shop_main_category": "601450",
"id": "7494707432875068089",
"region": "VN",
"shop_name": "Blanc Perfume",
"shop_sold_count_for_last_7_days": 0
},
{
"shop_rating": 4.6,
"shop_total_gmv": {
"unit": "VN",
"value": 314820832250.8305
},
"total_related_creator_count": 759,
"shop_product_count": 134,
"shop_total_sold_count": 259851,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 65117954385.85
},
"shop_main_category": "601450",
"id": "7495052674458552875",
"region": "VN",
"shop_name": "Blanc Perfume II",
"sold_count_trend": [
{
"value": 130,
"timestamp": "1789257600000"
},
{
"value": 205,
"timestamp": "1789344000000"
},
{
"value": 202,
"timestamp": "1789430400000"
},
{
"value": 173,
"timestamp": "1789516800000"
},
{
"value": 0,
"timestamp": "1789603200000"
},
{
"value": 248,
"timestamp": "1789689600000"
},
{
"value": 52,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 1010
},
{
"shop_rating": 4.8,
"shop_total_gmv": {
"unit": "VN",
"value": 78976379924.90076
},
"total_related_creator_count": 541,
"shop_product_count": 73,
"shop_total_sold_count": 821779,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 45951597956.920006
},
"shop_main_category": "601450",
"id": "7496060711434947355",
"region": "VN",
"shop_name": "Miss Saigon Premium Perfume",
"sold_count_trend": [
{
"value": 1232,
"timestamp": "1789257600000"
},
{
"value": 114,
"timestamp": "1789344000000"
},
{
"value": 62,
"timestamp": "1789430400000"
},
{
"value": 0,
"timestamp": "1789516800000"
},
{
"value": 0,
"timestamp": "1789603200000"
},
{
"value": 0,
"timestamp": "1789689600000"
},
{
"value": 0,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 1408
},
{
"shop_rating": 4.7,
"shop_total_gmv": {
"unit": "VN",
"value": 293969087042.171
},
"total_related_creator_count": 1028,
"shop_product_count": 45,
"shop_total_sold_count": 5131971,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 28590615365.22
},
"shop_main_category": "601450",
"id": "7495010746609863094",
"region": "VN",
"shop_name": "a:moures perfume",
"sold_count_trend": [
{
"value": 0,
"timestamp": "1789257600000"
},
{
"value": 0,
"timestamp": "1789344000000"
},
{
"value": 0,
"timestamp": "1789430400000"
},
{
"value": 2896,
"timestamp": "1789516800000"
},
{
"value": 0,
"timestamp": "1789603200000"
},
{
"value": 0,
"timestamp": "1789689600000"
},
{
"value": 612,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 3508
},
{
"shop_rating": 4.8,
"shop_total_gmv": {
"unit": "VN",
"value": 63821180137.129684
},
"total_related_creator_count": 577,
"shop_product_count": 93,
"shop_total_sold_count": 309374,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 17516051339.66
},
"shop_main_category": "601450",
"id": "7495055764843301081",
"region": "VN",
"shop_name": "Blanc Perfume HCM",
"sold_count_trend": [
{
"value": 331,
"timestamp": "1789257600000"
},
{
"value": 0,
"timestamp": "1789344000000"
},
{
"value": 0,
"timestamp": "1789430400000"
},
{
"value": 0,
"timestamp": "1789516800000"
},
{
"value": 0,
"timestamp": "1789603200000"
},
{
"value": 0,
"timestamp": "1789689600000"
},
{
"value": 908,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 1239
},
{
"shop_rating": 4,
"shop_total_gmv": {
"unit": "VN",
"value": 58830210315.81399
},
"total_related_creator_count": 76,
"shop_product_count": 65,
"shop_total_sold_count": 412863,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 14896927315.410002
},
"shop_main_category": "601450",
"id": "7494872862960749271",
"region": "VN",
"shop_name": "199Perfume.Store",
"shop_sold_count_for_last_7_days": 0
},
{
"shop_rating": 4.3,
"shop_total_gmv": {
"unit": "VN",
"value": 280007718216.99817
},
"total_related_creator_count": 258,
"shop_product_count": 11,
"shop_total_sold_count": 815476,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 12152932677.63
},
"shop_main_category": "601450",
"id": "7494612523282500499",
"region": "VN",
"shop_name": "Vonis Perfume",
"sold_count_trend": [
{
"value": 1,
"timestamp": "1789257600000"
},
{
"value": 3,
"timestamp": "1789344000000"
},
{
"value": 10,
"timestamp": "1789430400000"
},
{
"value": 3,
"timestamp": "1789516800000"
},
{
"value": 0,
"timestamp": "1789603200000"
},
{
"value": 0,
"timestamp": "1789689600000"
},
{
"value": 0,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 17
},
{
"shop_rating": 3.4,
"shop_total_gmv": {
"unit": "VN",
"value": 10984376892.78044
},
"total_related_creator_count": 63,
"shop_product_count": 33,
"shop_total_sold_count": 41084,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 7174437721.81
},
"shop_main_category": "601450",
"id": "7495363707148798772",
"region": "VN",
"shop_name": "Mai Thu - F Perfume Vietnam",
"sold_count_trend": [
{
"value": 0,
"timestamp": "1789257600000"
},
{
"value": 0,
"timestamp": "1789344000000"
},
{
"value": 0,
"timestamp": "1789430400000"
},
{
"value": 0,
"timestamp": "1789516800000"
},
{
"value": 173,
"timestamp": "1789603200000"
},
{
"value": 14,
"timestamp": "1789689600000"
},
{
"value": 3,
"timestamp": "1789776000000"
}
],
"shop_sold_count_for_last_7_days": 190
},
{
"shop_rating": 4.1,
"shop_total_gmv": {
"unit": "VN",
"value": 58517355972.17441
},
"total_related_creator_count": 165,
"shop_product_count": 118,
"shop_total_sold_count": 107726,
"shop_gmv_for_last_7_days": {
"unit": "VN",
"value": 6751751691.19
},
"shop_main_category": "601450",
"id": "7494865313718176744",
"region": "VN",
"shop_name": "Ken Perfume",
"shop_sold_count_for_last_7_days": 0
}
]
},
"request_id": "b02e5096-af7e-4fc7-a553-8743391cafae"
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en 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": "chuhaijiang-tiktok-shop-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_shop_search",
"arguments": {
"country": "vn",
"keyword": "perfume",
"page": 1,
"pageSize": 10,
"sort": "gmv_7d:desc"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-shop-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"items\":[{\"shop_name\":\"Công ty Cổ phần Charme Perfume\",\"id\":\"7494778581356677369\",\"shop_rating\":3.9,\"shop_total_gmv\":{\"value\":223904334719.94278,\"unit\":\"VN\"},\"total_related_creator_count\":501,\"shop_product_count\":50,\"shop_total_sold_count\":270665,\"shop_gmv_for_last_7_days\":{\"value\":122950089413.54001,\"unit\":\"VN\"},\"shop_main_category\":\"601450\",\"region\":\"VN\",\"sold_count_trend\":[{\"value\":265,\"timestamp\":\"1789257600000\"},{\"value\":56,\"timestamp\":\"1789344000000\"}],\"shop_sold_count_for_last_7_days\":504},{\"shop_name\":\"Blanc Perfume\",\"id\":\"7494707432875068089\",\"shop_rating\":4.4,\"shop_total_gmv\":{\"value\":569256790660.766,\"unit\":\"VN\"},\"total_related_creator_count\":1383,\"shop_product_count\":874,\"shop_total_sold_count\":1019414,\"shop_gmv_for_last_7_days\":{\"value\":70945345214.28,\"unit\":\"VN\"},\"shop_main_category\":\"601450\",\"region\":\"VN\",\"shop_sold_count_for_last_7_days\":0}],\"total_count\":472},\"request_id\":\"b02e5096-af7e-4fc7-a553-8743391cafae\"}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"items": [
{
"shop_name": "Công ty Cổ phần Charme Perfume",
"id": "7494778581356677369",
"shop_rating": 3.9,
"shop_total_gmv": {
"value": 223904334719.94278,
"unit": "VN"
},
"total_related_creator_count": 501,
"shop_product_count": 50,
"shop_total_sold_count": 270665,
"shop_gmv_for_last_7_days": {
"value": 122950089413.54001,
"unit": "VN"
},
"shop_main_category": "601450",
"region": "VN",
"sold_count_trend": [
{
"value": 265,
"timestamp": "1789257600000"
},
{
"value": 56,
"timestamp": "1789344000000"
}
],
"shop_sold_count_for_last_7_days": 504
},
{
"shop_name": "Blanc Perfume",
"id": "7494707432875068089",
"shop_rating": 4.4,
"shop_total_gmv": {
"value": 569256790660.766,
"unit": "VN"
},
"total_related_creator_count": 1383,
"shop_product_count": 874,
"shop_total_sold_count": 1019414,
"shop_gmv_for_last_7_days": {
"value": 70945345214.28,
"unit": "VN"
},
"shop_main_category": "601450",
"region": "VN",
"shop_sold_count_for_last_7_days": 0
}
],
"total_count": 472
},
"request_id": "b02e5096-af7e-4fc7-a553-8743391cafae"
}
},
"isError": false
}
}