Documentos
Ctrl+K Buscar Alt+[Alt+] Guías
Obtener clave API

Integraciones

Referencia de herramientas MCP (básica)

Esta es la versión en lenguaje sencillo de la lista de herramientas de MCP.

  • URL de MCP: https://app.winninghunter.com/mcp
  • Guía de configuración completa: Conectar MCP
  • Todas las herramientas son de solo lectura
  • Exitoso herramientas/llamada consume 1 crédito de API

Lista rápida (las 29 herramientas)

buscar_productos_en_TikTok
buscar_tiendas_en_TikTok
buscar_creadores_en_TikTok
buscar_vídeos_en_TikTok
contar_entidades_en_TikTok
explorar_categorías_en_TikTok
listar_los_más_populares_por_categoría_en_TikTok
autocompletar_en_TikTok
obtener_producto_en_TikTok
obtener_tienda_en_TikTok
obtener_creador_de_TikTok
obtener_vídeo_de_TikTok
obtener_productos_de_tendencia_en_TikTok
buscar_anuncios_de_Facebook
encontrar_productos_ganadores
paquete_de_inspiración_creativa
resumen_de_la_competencia
analizar_anuncio
radar_diario
analizar_marca_rastreada
lista_de_marcas_rastreadas
buscar_tiendas_de_Shopify
buscar_tiendas
encontrar_tiendas_similares
encontrar_tiendas_similares_por_imagen
buscar_temas_de_tendencia
obtener_detalles_de_temas_de_tendencia
autocompletar_temas_de_tendencia
comprobar_créditos

Cómo enfocar las

1) Buscar

Utiliza primero estos:

  • buscar_productos_en_TikTok
  • buscar_en_TikTok_Shops
  • buscar_creadores_de_TikTok
  • buscar_vídeos_en_TikTok
  • buscar_anuncios_en_Facebook
  • encontrar_productos_ganadores
  • paquete_de_inspiración_creativa
  • resumen_de_la_competencia
  • scan_ad
  • buscar_tiendas_de_Shopify
  • buscar_tiendas
  • buscar_tiendas_similares
  • buscar_tiendas_similares_por_imagen
  • temas_de_tendencia

2) Ver

Utiliza un identificador de los resultados de búsqueda:

  • obtener_producto_de_TikTok
  • get_tiktok_shop
  • obtener_creador_de_TikTok
  • obtener_vídeo_de_TikTok
  • obtener_detalles_del_tema_destacado

3)

  • número de entidades de TikTok (cifras por entidad)
  • explorar_categorías_de_TikTok (árbol de categorías y vistas)
  • lista_categorías_más_populares_de_TikTok (los artículos más destacados de una categoría)
  • autocompletar_tiktok (sugerencias al escribir)
  • temas_en_auge_con_autocompletado (sugerencias de temas)
  • obtener_productos_de_tendencia_en_TikTok ( trending en TikTok Shop)
  • daily_radar (cambios en la marca con seguimiento)
  • analizar_marca_rastreada (análisis en profundidad de una sola marca)
  • ver créditos (créditos API restantes)

más comunes#

La mayoría de los motores de búsqueda utilizan estos:

  • palabra clave
  • país
  • página
  • tamaño
  • ordenar por
  • orden de clasificación

Para las herramientas publicitarias de Meta (buscar_anuncios_en_Facebook, encontrar_productos_ganadores), ordenar por no es arbitrario. Utiliza una de las siguientes opciones:

  • pertinencia
  • fecha de hallazgo
  • última conexión
  • adspend
  • el más longevo
  • alcanzar
  • cantidad del conjunto de anuncios
  • coherencia
  • visitas mensuales
  • anuncios activos en la página

MCP normaliza automáticamente los alias más comunes:

  • creado, fecha_de_creación, fecha, reciente, más reciente, últimas noticias -> fecha de hallazgo
  • último_anuncio_iniciado -> última conexión
  • primero_anuncio_iniciado, el más antiguo, más temprano -> fecha de hallazgo en orden ascendente

La mayoría de las herramientas de detalle utilizan:

  • id
  • rodaja (¿qué parte quieres?)

Valores de corte para de detalle

Usa uno de estos rodaja valores:

  • obtener_producto_de_TikTok: detalle, historia, indicadores, creadores, vídeos
  • get_tiktok_shop: detalle, historia, indicadores, productos, vídeos, creadores, estrategia
  • obtener_creador_de_TikTok: detalle, historia, indicadores, tiendas, productos, vídeos
  • obtener_vídeo_de_TikTok: detalle, historia, indicadores, productos, similar

Dos comunes#

  1. Trending

    • obtener_productos_de_tendencia_en_TikTok ¿Cuál es el impulso de los productos de TikTok Shop?
    • «Exploding Topics» es independiente (temas_de_tendencia + obtener_detalles_del_tema_destacado)

  2. Acciones de escritura

    • El MCP es de solo lectura
    • Los favoritos, los ajustes preestablecidos, las transcripciones y otros contenidos escritos deben utilizar la API REST

Bloque de texto para de IA#

Pega esto en las instrucciones para el agente:

Utiliza WinningHunter MCP en https://app.winninghunter.com/mcp.
La autenticación puede realizarse mediante un token OAuth de tipo «bearer» (flujo de conector) o una clave X-API (clientes compatibles con encabezados).
Todas las herramientas MCP son de solo lectura.
Las herramientas/llamadas que se ejecutan correctamente cuestan 1 crédito API.
Si el usuario solicita operaciones de escritura (favoritos/preajustes/transcripciones), utilice REST /api/v1/tiktok-shop/* en su lugar.
Si no está seguro del esquema exacto, llame primero a tools/list.

¿Necesitas toda la información técnica?

Para obtener información detallada sobre la semántica de los filtros y el comportamiento de los puntos finales: