Inteligencia comercial de TikTok CJ

API de búsqueda de productos por imagen de TikTok MCP

Encontrar TikTok Compra productos similares a una imagen. Llama a la TikTok Búsqueda de imagen de producto API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent 63 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de búsqueda de productos por imagen 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 Comprar productos similares a una imagen

2. Revisar coincidencias visuales con las puntuaciones del producto

Prompt: Encontrar TikTok Comprar productos similares a una imagen para [uploaded image reference] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta. Presenta imágenes de productos devueltos junto con sus calificaciones para revisión manual. No reclamar la identidad exacta, la semejanza de imagen puntua o rendimiento de ventas de estos campos.

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.

Proporcione una imagen que pueda acceder y utilizar. La similitud visual por sí sola no demuestra identidad de producto, propiedad de marca o autorización de proveedor.

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_chuhaijiang_tiktok_product_image_search

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": "chuhaijiang-tiktok-product-image-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_product_image_search",
    "arguments": {
      "country": "US",
      "osKey": ""
    }
  }
}

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
`osKey`	`string`	obligatorio	osKey devuelto después de subir la imagen a través de Nexscope flujo de carga del proveedor; obtener este valor antes de llamar. Ejemplo:
`country`	`string`	opcional	Código de mercado de dos letras superior. Ejemplo: US

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	Lista de productos similares en `data.items[]`, total `data.total_count`
`product_images`	`object/array`	opcional	Fotos de productos
`product_rating`	`number`	opcional	calificación del producto

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

Encontrar TikTok Compra productos similares a una imagen. Uso de referencia de imagen subida upload/859cbe9b_1793090839483829690.jpg. Concéntrate en US.

Respuesta de ejemplo

En la muestra publicada, el nombre del producto es «Women's Fashionable Woven Pu Leather Handbag, Casual Versatile Crossbody Bag for Daily Used, Trendy All-match Commuter Stylish Versatile Bag». La categoría de primer nivel (l1) es 824584 y el recuento de unidades vendidas es 0. Estas observaciones solo corresponden al registro y al período 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

{
  "osKey": "upload/859cbe9b_1793090839483829690.jpg",
  "country": "US"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": {
      "total_count": 1000,
      "items": [
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730284616949797148/edee488fe3968b7f3d41dca78bf01682~tplv-fhlh96nyum-crop-webp:200:200.webp?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730284616949797148/edee488fe3968b7f3d41dca78bf01682~tplv-fhlh96nyum-crop-webp:1800:1800.webp?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1730284616949797148",
          "ceiling_price": {
            "unit": "US",
            "value": 39.89
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 28.49
          },
          "product_name": "Women's Fashionable Woven Pu Leather Handbag, Casual Versatile Crossbody Bag for Daily Used, Trendy All-match Commuter Stylish Versatile Bag"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730700824997236806/384c371631e842ccabff59aedfc1a998~tplv-fhlh96nyum-crop-webp:200:200.webp?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730700824997236806/384c371631e842ccabff59aedfc1a998~tplv-fhlh96nyum-crop-webp:800:800.webp?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 181,
          "id": "1730700824997236806",
          "ceiling_price": {
            "unit": "US",
            "value": 69
          },
          "product_gmv": {
            "unit": "US",
            "value": 5432.19
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 69
          },
          "product_name": "Woven Evening Purses for Women Casual Leather Handbags Fashion Cute Crossbody Bags Clutch Purses"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730860413851505276/2bdbe50b2bb64805817ea6fcdeafe0ba~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730860413851505276/2bdbe50b2bb64805817ea6fcdeafe0ba~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1730860413851505276",
          "ceiling_price": {
            "unit": "US",
            "value": 49
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 49
          },
          "product_name": "Women's Viral Woven Tote - Chic Vintage Everyday Bag Purse Leather Satchel"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730354188406919954/9a4d9a4759794b56b67af9f7360e9d3d~tplv-omjb5zjo8w-resize-jpeg:200:200.jpeg?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730354188406919954/9a4d9a4759794b56b67af9f7360e9d3d~tplv-omjb5zjo8w-resize-jpeg:800:800.jpeg?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1730354188406919954",
          "ceiling_price": {
            "unit": "US",
            "value": 56.63
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 46.9
          },
          "product_name": "Spring/Summer New Knitted Handbag, Old French Stick Bag, Organ Bag, Crossbody Bag (Suitable for Various Party, Banquet, and Party Occasions)"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1729709423024902489/ca861364460e47b5bde9e3df7cf59da6~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1729709423024902489/ca861364460e47b5bde9e3df7cf59da6~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1729709423024902489",
          "ceiling_price": {
            "unit": "US",
            "value": 69
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 49
          },
          "product_name": "Miami 31 Vegan Leather Woven Clutch Top Handle Bag"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1731779456322540409/2fe3846176f4482e96bb05edd747827f~tplv-fhlh96nyum-crop-webp:200:200.webp?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1731779456322540409/2fe3846176f4482e96bb05edd747827f~tplv-fhlh96nyum-crop-webp:800:800.webp?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 292,
          "id": "1731779456322540409",
          "ceiling_price": {
            "unit": "US",
            "value": 53.58
          },
          "product_gmv": {
            "unit": "US",
            "value": 9175.66
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 53.58
          },
          "product_name": "6195-1 Women's Retro Handbag 2025 New Woven PU Leather Matte Long Dinner Shoulder Bag"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730951628632133861/b10d4e2f85f7422fa7bf97ea7674cc82~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730951628632133861/b10d4e2f85f7422fa7bf97ea7674cc82~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1730951628632133861",
          "ceiling_price": {
            "unit": "US",
            "value": 35
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 35
          },
          "product_name": "Trendy Woven Crossbody Purse Square Box Bags Women Shoulder Bag Cute Satchels Mini PU Leather Top-Handle Handbag"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1729544660826230828/a6eefb52932e4ac78b0d8f22bd80c439~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1729544660826230828/a6eefb52932e4ac78b0d8f22bd80c439~tplv-fhlh96nyum-crop-webp:867:867.webp?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1729544660826230828",
          "ceiling_price": {
            "unit": "US",
            "value": 47
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 47
          },
          "product_name": "Woven Bag Shoulder Fashion Clutch Crossbody Bag"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730647436162142421/6716a362be424b01ad8c66619964feaa~tplv-fhlh96nyum-crop-webp:200:200.webp?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1730647436162142421/6716a362be424b01ad8c66619964feaa~tplv-fhlh96nyum-crop-webp:1800:1800.webp?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 238,
          "id": "1730647436162142421",
          "ceiling_price": {
            "unit": "US",
            "value": 21.6
          },
          "product_gmv": {
            "unit": "US",
            "value": 6217.01
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 21.6
          },
          "product_name": "Women's Fashionable Snakeskin Embossed Handbag, Street Trendy PU Leather Crossbody Bag, Trendy All-match Purses Crossbody Bag for Daily Use"
        },
        {
          "product_images": [
            {
              "thumb_url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1732082705325330548/17a1514c60624dc7ad62b4af1a28f39c~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?sign=REDACTED",
              "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_product/p-1732082705325330548/17a1514c60624dc7ad62b4af1a28f39c~tplv-fhlh96nyum-crop-webp:1350:1800.webp?sign=REDACTED"
            }
          ],
          "l1_category": "824584",
          "product_sold_count": 0,
          "id": "1732082705325330548",
          "ceiling_price": {
            "unit": "US",
            "value": 10.89
          },
          "product_gmv": {
            "unit": "US",
            "value": 0
          },
          "region": "US",
          "floor_price": {
            "unit": "US",
            "value": 10.21
          },
          "product_name": "25 fall&winter Fashionable Solid Color Handbag, Casual Versatile Crossbody Bag for Women, Trendy All-match Commuter Bag for Daily Used, Elegant Commuter Bag"
        }
      ]
    },
    "request_id": "c68cc677-7585-46a9-81c7-32f47094647d"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos