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

Integraciones

Conecta WinningHunter con herramientas de IA

WinningHunter tiene un punto de conexión MCP:

https://app.winninghunter.com/mcp

Si tienes tu propia instalación, utiliza tu propio dominio con /mcp al final.

Esta página es deliberadamente sencilla: dónde hacer clic, qué pegar y cómo comprobar que funciona.

Antes de

Necesitas:

  1. URL de MCP (https://app.winninghunter.com/mcp)
  2. Un método de autenticación:
    • OAuth (recomendado para interfaces de usuario de conectores, como el conector personalizado de Claude)
    • Encabezado de la clave API (X-API-Key: wh_...) para clientes compatibles con encabezados (Cursor, n8n, Desktop JSON)

Los metadatos de descubrimiento de OAuth están disponibles en:

  • https://app.winninghunter.com/.well-known/oauth-authorization-server/mcp
  • https://app.winninghunter.com/.well-known/oauth-authorization-server

Claude (conector personalizado)

  1. Abierto: https://claude.ai/settings/connectors?modal=add-custom-connector
  2. Haz clic en «Añadir conector personalizado».
  3. Escribe cualquier nombre (por ejemplo WinningHunter).
  4. Pega la URL de MCP: https://app.winninghunter.com/mcp
  5. Haz clic en «Conectar».
  6. Claude iniciará el inicio de sesión mediante OAuth y te pedirá que inicies sesión en WinningHunter.
  7. Autoriza el acceso y luego vuelve con Claude.

Para la configuración de JSON local/de escritorio, utiliza:

{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Comprobación realizada: abre un nuevo chat y pide a Claude que te enumere las herramientas disponibles. Deberías ver las herramientas de WinningHunter.

Cursor (3 pasos)

  1. Abrir la configuración del cursor para MCP (o crear .cursor/mcp.json en tu proyecto).
  2. Pega el mismo JSON que el anterior.
  3. Guarda y, a continuación, vuelve a cargar MCP (o reinicia Cursor).
{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Comprobación realizada: pide a Cursor que llame o muestre las herramientas MCP de WinningHunter.

Cursor puede seguir utilizando encabezados con claves API. El uso de OAuth es opcional en este caso.

ChatGPT (OpenAI)

Si en tu espacio de trabajo tienes habilitadas las aplicaciones y MCP, haz lo siguiente:

  1. Abre la configuración de ChatGPT.
  2. Ve a Aplicaciones -> Ajustes avanzados.
  3. Activa el modo de desarrollador.
  4. Haz clic en «Crear una aplicación».
  5. Introduce el nombre de cualquier aplicación (por ejemplo WinningHunter).
  6. Establece la URL del servidor MCP en https://app.winninghunter.com/mcp.
  7. Haz clic en «Crear» (o en «Conectar», según la interfaz de usuario).

Si ChatGPT admite OAuth para el flujo de tu conector, utiliza OAuth. Si, por el contrario, tu pantalla admite encabezados personalizados, puedes seguir utilizando Clave X-API.

Documentación de OpenAI MCP: MCP para aplicaciones de ChatGPT

Gemini (Google)

Si tu cuenta de Gemini es compatible con los conectores MCP:

  1. Añadir un servidor MCP.
  2. Utilizar URL https://app.winninghunter.com/mcp.
  3. Utiliza OAuth cuando Gemini lo solicite. Si tu cliente admite la autenticación por encabezado, Clave X-API también es compatible.

Documentación de Gemini MCP: Servidores MCP con la CLI de Gemini

Utiliza el nodo «MCP Client» (o el nodo «MCP Client Tool»):

  1. Añade un nodo MCP a tu flujo de trabajo.
  2. Establece la URL del servidor en https://app.winninghunter.com/mcp.
  3. Añadir encabezado de autenticación: Clave X-API = tu ¿Qué...? clave.

Documentación de n8n: Cliente MCP

Qué incluye

Puedes consultar:

  • Productos, tiendas, creadores, vídeos, categorías y trending de TikTok Shop
  • Búsqueda en la biblioteca de anuncios de Meta
  • Lista de seguimiento de marcas
  • Búsqueda en la tienda de Shopify
  • Búsqueda y detalles de «Exploding Topics»
  • Comprobación del saldo acreedor

Todas las herramientas de MCP son de solo lectura.

Si necesitas guardar favoritos, configuraciones predefinidas, transcripciones u otros contenidos escritos, utiliza la API REST (/api/v1/tiktok-shop/*).

Créditos y límites (versión simplificada)

  • herramientas/llamada éxito = 1 crédito API
  • herramientas/lista y comprueban la conexión no cobrar
  • Si falta la autenticación o esta no es válida, se produce 401
  • Si la cuenta no tiene acceso a la API, 403

Más información: Créditos y facturación, Límites de velocidad, Solución de problemas

siguiente#

¿Necesitas los nombres exactos de las herramientas y sus argumentos? Abre:

Referencia de herramientas MCP