Docs
Ctrl+K Rechercher Alt+[Alt+] Guides
Obtenir une clé API

Intégrations

Connectez WinningHunter à des outils d'IA

WinningHunter dispose d'un point de terminaison MCP :

https://app.winninghunter.com/mcp

Si vous gérez votre propre installation, utilisez votre propre domaine avec /mcp à la fin.

Cette page est volontairement simple : où cliquer, quoi coller et comment vérifier que ça fonctionne.


Avant de

Il vous faut :

  1. URL MCP (https://app.winninghunter.com/mcp)
  2. Une méthode d'authentification :
    • OAuth (recommandé pour les interfaces utilisateur de connecteurs telles que le connecteur personnalisé Claude)
    • En-tête de clé API (Clé X-API : wh_...) pour les clients prenant en charge les en-têtes (Cursor, n8n, Desktop JSON)

Les métadonnées de découverte OAuth sont disponibles à l'adresse suivante :

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

Claude (connecteur personnalisé)

  1. Ouvert : https://claude.ai/settings/connectors?modal=add-custom-connector
  2. Cliquez sur « Ajouter un connecteur personnalisé ».
  3. Entrez un nom (par exemple Chasseur gagnant).
  4. Collez l'URL MCP : https://app.winninghunter.com/mcp
  5. Cliquez sur « Se connecter ».
  6. Claude va lancer la connexion via OAuth et vous demandera de vous connecter à WinningHunter.
  7. Validez l'accès, puis retournez voir Claude.

Pour la configuration JSON locale/sur le bureau, utilisez :

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

Vérification effectuée : ouvrez une nouvelle conversation et demandez à Claude de vous énumérer les outils disponibles. Vous devriez voir les outils WinningHunter.


Curseur (3 étapes)

  1. Ouvrir les paramètres du curseur pour MCP (ou créer .cursor/mcp.json (dans votre projet).
  2. Collez le même fichier JSON que ci-dessus.
  3. Enregistrez, puis rechargez MCP (ou redémarrez Cursor).
{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Vérification effectuée : demandez à Cursor d'appeler ou d'afficher la liste des outils MCP de WinningHunter.

Cursor peut continuer à utiliser les en-têtes de clé API. L'OAuth est facultatif dans ce cas.


ChatGPT (OpenAI)

Si la fonctionnalité « Apps + MCP » est activée dans votre espace de travail, procédez comme suit :

  1. Ouvrez les paramètres de ChatGPT.
  2. Allez dans Applications -> Paramètres avancés.
  3. Activez le mode développeur.
  4. Cliquez sur « Créer une application ».
  5. Choisissez le nom de l'application (par exemple Chasseur gagnant).
  6. Définissez l'URL du serveur MCP sur https://app.winninghunter.com/mcp.
  7. Cliquez sur Créer (ou Connecter, selon l'interface utilisateur).

Si ChatGPT prend en charge OAuth pour le flux de votre connecteur, utilisez OAuth. Si votre écran prend plutôt en charge les en-têtes personnalisés, vous pouvez tout de même utiliser Clé X-API.

Documentation MCP d'OpenAI : MCP pour les applications ChatGPT


Gemini (Google)

Si votre compte Gemini prend en charge les connecteurs MCP :

  1. Ajouter un serveur MCP.
  2. Utiliser l'URL https://app.winninghunter.com/mcp.
  3. Privilégiez OAuth lorsque Gemini le demande. Si l'authentification par en-tête est disponible dans votre client, Clé X-API est également pris en charge.

Documentation Gemini MCP : serveurs MCP avec l'interface CLI Gemini


Utilisez le nœud « MCP Client » (ou le nœud « MCP Client Tool ») :

  1. Ajoutez un nœud MCP à votre flux de travail.
  2. Définissez l'URL du serveur sur https://app.winninghunter.com/mcp.
  3. Ajouter l'en-tête auth : Clé X-API = ton wh_... clé.

Documentation n8n : Client MCP


Ce que vous

Vous pouvez effectuer une recherche :

  • Produits, boutiques, créateurs, vidéos, catégories et trending de TikTok Shop
  • Recherche dans la bibliothèque de publicités Meta
  • Liste des marques suivies
  • Recherche dans la boutique Shopify
  • Recherche et détails sur les sujets d'actualité
  • Vérification du solde créditeur

Tous les outils MCP sont en lecture seule.

Si vous avez besoin d'enregistrer des favoris, des préréglages, des transcriptions ou d'autres contenus, utilisez l'API REST (/api/v1/tiktok-shop/*).


Crédits et limites (version simplifiée)

  • outils/appel succès = 1 crédit API
  • outils/liste et effectuer des contrôles de connexion pas frais
  • Une authentification manquante ou non valide entraîne 401
  • L'absence d'accès à l'API sur le compte entraîne 403

Plus d'informations : Crédits et facturation, Limites de débit, Dépannage


suivante#

Vous avez besoin des noms exacts des outils et de leurs arguments ? Ouvrez :

Référence des outils MCP