Dokumente
Strg+K Suchen Alt+[Alt+] Hilfslinien
API-Schlüssel abrufen

Integrationen

Verbinden Sie WinningHunter mit KI-Tools

WinningHunter verfügt über einen MCP-Endpunkt:

https://app.winninghunter.com/mcp

Wenn Sie eine eigene Installation betreiben, verwenden Sie Ihre eigene Domain mit /mcp am Ende.

Diese Seite ist bewusst einfach gehalten: Wo man klicken muss, was man einfügen muss und wie man überprüft, ob es funktioniert.

Empfehlung: Verwenden Sie Claude, wenn Sie sich nicht sicher sind, mit welchem Client Sie beginnen sollen. Der benutzerdefinierte Konnektor-Ablauf nutzt OAuth, sodass die Einrichtung in der Regel am schnellsten und am wenigsten fehleranfällig ist.

Bevor Sie

Du benötigst:

  1. MCP-URL (https://app.winninghunter.com/mcp)
  2. Eine Authentifizierungsmethode:
    • OAuth (empfohlen für Konnektor-Benutzeroberflächen wie den benutzerdefinierten Konnektor „Claude“)
    • API-Schlüssel-Header (X-API-Key: wh_...) für Clients mit Header-Unterstützung (Cursor, n8n, Desktop JSON)

Die OAuth-Erkennungsmetadaten sind verfügbar unter:

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

Claude (benutzerdefinierter Anschluss)

  1. Geöffnet: https://claude.ai/settings/connectors?modal=add-custom-connector
  2. Klicken Sie auf „Benutzerdefinierten Konnektor hinzufügen“.
  3. Geben Sie einen beliebigen Namen ein (zum Beispiel WinningHunter).
  4. MCP-URL einfügen: https://app.winninghunter.com/mcp
  5. Klicken Sie auf „Verbinden“.
  6. Claude startet die OAuth-Anmeldung und fordert dich auf, dich bei WinningHunter anzumelden.
  7. Genehmige den Zugang und kehre dann zu Claude zurück.

Für die lokale/Desktop-JSON-Konfiguration verwende:

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

Überprüfung abgeschlossen: Öffne einen neuen Chat und bitte Claude, die verfügbaren Tools aufzulisten. Du solltest die WinningHunter-Tools sehen.

Cursor (3 Schritte)

  1. Cursor-Einstellungen für MCP öffnen (oder erstellen) .cursor/mcp.json (in Ihrem Projekt).
  2. Füge denselben JSON-Code wie oben ein.
  3. Speichern Sie die Datei und laden Sie MCP neu (oder starten Sie Cursor neu).
{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Überprüfung abgeschlossen: Fordere Cursor auf, die WinningHunter-MCP-Tools aufzurufen oder aufzulisten.

Cursor kann weiterhin API-Schlüssel-Header verwenden. OAuth ist dort optional.

ChatGPT (OpenAI)

Wenn in Ihrem Arbeitsbereich „Apps + MCP“ aktiviert ist, gehen Sie wie folgt vor:

  1. Öffnen Sie die ChatGPT -Einstellungen.
  2. Gehe zu „Apps “ -> „Erweiterte Einstellungen“.
  3. Aktivieren Sie den Entwicklermodus.
  4. Klicken Sie auf „App erstellen“.
  5. Geben Sie einen beliebigen App-Namen ein (zum Beispiel WinningHunter).
  6. Stellen Sie die MCP-Server-URL auf https://app.winninghunter.com/mcp.
  7. Klicken Sie auf „Erstellen“ (oder „Verbinden“, je nach Benutzeroberfläche).

Wenn ChatGPT OAuth für Ihren Konnektor-Ablauf unterstützt, verwenden Sie OAuth. Wenn Ihr Bildschirm stattdessen benutzerdefinierte Header unterstützt, können Sie weiterhin X-API-Schlüssel.

OpenAI MCP-Dokumentation: MCP für ChatGPT-Apps

Gemini (Google)

Wenn Ihr Gemini-Konto MCP-Konnektoren unterstützt:

  1. Einen MCP-Server hinzufügen.
  2. URL verwenden https://app.winninghunter.com/mcp.
  3. Verwende OAuth, wenn Gemini dies verlangt. Falls in deinem Client die Authentifizierung über den Header verfügbar ist, X-API-Schlüssel wird ebenfalls unterstützt.

Gemini MCP-Dokumentation: MCP-Server mit Gemini CLI

Verwenden Sie den Knoten „MCP Client“ (oder den Knoten „MCP Client Tool“):

  1. Fügen Sie den MCP-Knoten in Ihren Workflow ein.
  2. Server-URL festlegen auf https://app.winninghunter.com/mcp.
  3. Header „auth“ hinzufügen: X-API-Schlüssel = dein wh_... Schlüssel.

n8n-Dokumentation: MCP-Client

Was Sie

Sie können folgende Abfrage durchführen:

  • TikTok Shop: Produkte, Shops, Creator, Videos, Kategorien, trending
  • Suche in der Meta-Anzeigenbibliothek
  • Liste der Marken-Tracker, Analyse und Verfolgung neuer Meta-Seiten
  • Shopify-Shop-Suche und Verfolgung neuer Shops/Domains
  • Exploding Topics – Suche + Details
  • Überprüfung des Guthabens

Die meisten MCP-Tools sind schreibgeschützt. Marke und track_store Fügen Sie Artikel zu Ihren WinningHunter-Tracker hinzu.

Wenn Sie Favoriten, Voreinstellungen, Transkripte oder andere Daten speichern möchten, verwenden Sie die REST-API (/api/v1/tiktok-shop/*).

Guthaben und Limits (einfache Version)

  • Tools/Anruf Erfolg = 1 API-Guthaben
  • Werkzeuge/Liste und die Verbindungstests führen nicht Gebühr
  • Fehlende/ungültige Authentifizierung führt zu 401
  • Der Account verfügt über keinen API-Zugriff 403

Alle Details: Gutschriften und Abrechnung, Ratenbegrenzungen, Fehlerbehebung

Nächste

Benötigen Sie die genauen Namen der Tools und deren Argumente? Öffnen Sie:

MCP-Tools – Referenz