Inteligencia de TikTok FM

API de descubrimiento de productos de TikTok MCP

Búsqueda y filtro global TikTok Compra productos por palabra clave, categoría, tipo de tienda, comisión, ventas, cuenta creador y clasificación. Disponible 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 descubrimiento 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. Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta. Para esta selección, elija Estados Unidos, Reino Unido, México, España, Alemania, Italia, Francia, Indonesia, Vietnam, Malasia, Tailandia, Filipinas, Brasil, Japón o Singapur.

2. Continuar los resultados dentro de un límite de página

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [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: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [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. Para esta selección, elija ventas de 7 días, 7 días GMV, tasa de comisión, ventas totales, total GMV o el creador cuenta.

4. Encontrar coincidencias por volumen de ventas

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen sales volume range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

5. Encontrar coincidencias por tasa de la Comisión

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen commission rate range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

6. Encontrar coincidencias por el Conde Creador

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen creator count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

7. Resultados estrechos por nombre de la categoría de inglés

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Uso [my selected english category name] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

8. Elija Tiendas Locales o Transfronterizas

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Concéntrate en [local stores or cross-border stores], según mi preferencia de abastecimiento. Resumir sólo los registros devueltos.

9. Buscar productos de venta óptima

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limita la búsqueda a los productos marcados como muy vendidos. Informe sólo lo que los registros seleccionados soportan.

10. Buscar productos nuevos

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limita la búsqueda a los productos publicados recientemente. Informe sólo lo que los registros seleccionados soportan.

11. Encontrar productos totalmente gestionados

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limita la búsqueda a los productos de TikTok con gestión integral. Informe sólo lo que los registros seleccionados soportan.

12. Buscar productos con envío gratis

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Limita la búsqueda a los productos con envío gratuito. Informe sólo lo que los registros seleccionados soportan.

13. Buscar productos locales de invernadero

Prompt: Encontrar TikTok Productos de la tienda que coinciden con mis criterios de selección [search phrase] dentro [target marketplace]. Restringir la búsqueda a los productos enviados desde un almacén local. 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_discovery

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-discovery-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_product_discovery",
    "arguments": {
      "keyword": "phone case",
      "page": 1,
      "pageSize": 10,
      "region": "US"
    }
  }
}

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
`keyword`	`string`	opcional	Palabra clave de búsqueda (fuzzy match on product title) Ejemplo: phone case
`region`	`string`	opcional	Código de la región del mercado. Opciones: US (Estados Unidos) GB (Reino Unido), MX (México) ES (España), DE (Alemania), IT (Italia) FR (Francia), ID (Indonesia), VN (Vietnam), MY (Malasia), TH (Tailandia), PH (Filipinas), BR (Brasil), JP (Japón), SG (Singapur) Ejemplo: US
`category`	`string`	opcional	Nombre de la categoría en inglés, coincide automáticamente con TikTok categoría ID. La entrada no inglesa debe traducirse al inglés primero
`shopType`	`integer`	opcional	Tipo de tienda: 1=local store, 2=cross-border store Ejemplo: 1
`isTopSelling`	`boolean`	opcional	Filtrar productos de venta caliente sólo Ejemplo: false
`isNewListed`	`boolean`	opcional	Filtrar productos recién listados solamente Ejemplo: false
`isSshop`	`boolean`	opcional	Filtro TikTok productos totalmente gestionados (S-shop) solamente Ejemplo: false
`isFreeShipping`	`boolean`	opcional	Filtrar productos de envío gratuitos solamente Ejemplo: false
`isLocalWarehouse`	`boolean`	opcional	Filtrar productos de envío de almacén local solamente Ejemplo: false
`unitsSoldRange`	`object`	opcional	Filtro de rango de volumen de ventas, formato: {"min": 100, "max": 5000} Ejemplo: {}
`commissionRateRange`	`object`	opcional	Filtro de rango de tarifas de la Comisión, formato: {"min": 0.05, "max": 0.20} (decimal, 0,10=10%) Ejemplo: {}
`creatorCountRange`	`object`	opcional	Filtro de rango de cuenta de creador, formato: {"min": 10, "max": 500} Ejemplo: {}
`orderField`	`string`	opcional	Campo tipo: day7_units_sold (7 días de ventas), day7_gmv (7-día GMV), commission_rate (tasa de la comisión) total_units_sold (ventas totales), total_gmv (total) GMV), creator_count (Conteo de generadores). Orden descendente predeterminado
`page`	`integer`	opcional	Número de página, por defecto 1 Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, max 10, default 10 Ejemplo: 10

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`total`	`integer`	opcional	El número total de registros que cumplen los criterios.
`products`	`array`	opcional	Lista de información de productos, campos de objeto de producto se muestran en la tabla siguiente.
`columns`	`array`	opcional	Definiciones de columna Render.
`type`	`string`	opcional	Rendering tipo de estilo.
`costToken`	`integer`	opcional	El número de fichas consumidas.
`title`	`string`	opcional	Título del producto.
`productId`	`string`	opcional	Identificación única del producto ID.
`region`	`string`	opcional	Código de área de mercado.
`price`	`number`	opcional	Precio del producto.
`minPrice`	`number`	opcional	precio más bajo.
`maxPrice`	`number`	opcional	Precio más alto.
`currency`	`string`	opcional	Código de moneda.
`totalSaleCnt`	`integer`	opcional	Ventas totales acumuladas.
`totalSale1dCnt`	`integer`	opcional	1 día de ventas.
`totalSale7dCnt`	`integer`	opcional	7 días de ventas.
`totalSale28dCnt`	`integer`	opcional	28 días de ventas.
`totalSale90dCnt`	`integer`	opcional	Ventas de 90 días.
`totalSaleGmvAmt`	`number`	opcional	Total acumulativo GMV.
`totalSaleGmv7dAmt`	`number`	opcional	7 días GMV.
`totalSaleGmv28dAmt`	`number`	opcional	28 días GMV.
`totalVideoCnt`	`integer`	opcional	Número de vídeos con mercancías.
`totalLiveCnt`	`integer`	opcional	Número de mercancías entregadas en vivo.
`totalIflCnt`	`integer`	opcional	Traiga el número de personas con bienes.
`productCommissionRate`	`number`	opcional	Tasa de comisión de productos (decimal, `0.10`=10%).
`productRating`	`number`	opcional	Evaluaciones de productos.
`reviewCount`	`integer`	opcional	Número de comentarios.
`skuCount`	`integer`	opcional	SKU cantidad.
`shopName`	`string`	opcional	Nombre de la tienda.
`shopSellerId`	`string`	opcional	Vendedor ID.
`shopTotalUnitsSold`	`integer`	opcional	El volumen total de ventas de la tienda.
`isCrossBorder`	`integer`	opcional	Ya sea transfronteriza: `1`= transfronteriza, `0`= local.
`isSShopText`	`string`	opcional	Ya sea para albergar completamente la tienda (yes/no).
`freeShippingText`	`string`	opcional	Ya sea el envío es gratuito (yes/no).
`availableDate`	`string`	opcional	Tiempo de estante.
`categoryName`	`string`	opcional	Nombre de la categoría de producto.
`salesTrendFlagText`	`string`	opcional	Etiquetas de tendencia de ventas.
`tiktokUrl`	`string`	opcional	TikTok enlace de mercancías.
`imageUrl`	`string`	opcional	Imagen del producto URL.

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Encontrar TikTok Comprar productos que coincidan con mis criterios de selección. Usar “casa de teléfono”. Centrarse en el US.

Explicación ilustrativa de la respuesta

El resultado ilustrativo muestra el título: Ejemplo producto; producto id: ejemplo-productId; precio: 19.99. 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": "tiktok-product-discovery-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_product_discovery",
    "arguments": {
      "keyword": "phone case",
      "page": 1,
      "pageSize": 10,
      "region": "US"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "tiktok-product-discovery-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Example product\",\"productId\":\"example-productId\",\"price\":19.99}]}}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "products": [
          {
            "title": "Example product",
            "productId": "example-productId",
            "price": 19.99
          }
        ]
      }
    },
    "isError": false
  }
}