Belgeler
Ctrl+K Arama Alt+[Alt+] Kılavuzlar
API anahtarını al

Entegrasyonlar

WinningHunter'ı yapay zeka araçlarına bağlayın

WinningHunter'ın bir MCP uç noktası vardır:

https://app.winninghunter.com/mcp

Kendi kurulumunuzu yapıyorsanız, kendi alan adınızı şu şekilde kullanın: /mcp sonunda.

Bu sayfa kasıtlı olarak basit tutulmuştur: nereye tıklanacağı, neyin yapıştırılacağı ve çalışıp çalışmadığının nasıl kontrol edileceği.


Başlamadan önce

İhtiyacınız olan şeyler:

  1. MCP URL'si (https://app.winninghunter.com/mcp)
  2. Tek bir kimlik doğrulama yöntemi:
    • OAuth (Claude özel bağlayıcı gibi bağlayıcı kullanıcı arayüzleri için önerilir)
    • API anahtarı başlığı (X-API-Key: wh_...) başlık desteği olan istemciler için (Cursor, n8n, Desktop JSON)

OAuth keşif meta verileri şu adreste bulunabilir:

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

Claude (özel konektör)

  1. Açık: https://claude.ai/settings/connectors?modal=add-custom-connector
  2. " Özel bağlayıcı ekle" seçeneğine tıklayın.
  3. Herhangi bir isim girin (örneğin WinningHunter).
  4. MCP URL'sini yapıştır: https://app.winninghunter.com/mcp
  5. " Bağlan" düğmesine tıklayın.
  6. Claude, OAuth oturum açma işlemini başlatacak ve sizden WinningHunter'da oturum açmanızı isteyecektir.
  7. Erişimi onaylayın, ardından Claude'a dönün.

Yerel/Masaüstü JSON kurulumu için şunu kullanın:

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

Kontrol tamamlandı: Yeni bir sohbet penceresi açın ve Claude'dan mevcut araçları listelemesini isteyin. WinningHunter araçlarını görmelisiniz.


İmleç (3 adım)

  1. MCP için İmleç ayarlarını aç (veya oluştur) .cursor/mcp.json (projenizde).
  2. Yukarıdaki JSON'u yapıştırın.
  3. Kaydedin, ardından MCP'yi yeniden yükleyin (veya Cursor'u yeniden başlatın).
{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Kontrol tamamlandı: Cursor'dan WinningHunter MCP araçlarını çağırmasını veya listelemesini isteyin.

Cursor, API anahtarı başlıklarını kullanmaya devam edebilir. Bu durumda OAuth isteğe bağlıdır.


ChatGPT (OpenAI)

Çalışma alanınızda Apps + MCP etkinse, şu adımları izleyin:

  1. ChatGPT Ayarlarını açın.
  2. Uygulamalar -> Gelişmiş ayarlar'a gidin.
  3. Geliştirici modunu etkinleştirin.
  4. " Uygulama oluştur" seçeneğine tıklayın.
  5. İstediğiniz herhangi bir uygulama adını girin (örneğin WinningHunter).
  6. MCP sunucu URL'sini şu şekilde ayarlayın: https://app.winninghunter.com/mcp.
  7. Oluştur'a tıklayın (kullanıcı arayüzüne bağlı olarak Bağlan'a da tıklayabilirsiniz).

ChatGPT, konektör akışınız için OAuth'u destekliyorsa OAuth'u kullanın. Ekranınız bunun yerine özel başlıkları destekliyorsa, yine de X-API-Anahtarı.

OpenAI MCP belgeleri: ChatGPT Uygulamaları için MCP


İkizler (Google)

Gemini hesabınız MCP bağlayıcılarını destekliyorsa:

  1. Bir MCP sunucusu ekleyin.
  2. URL'yi kullan https://app.winninghunter.com/mcp.
  3. Gemini bunu talep ettiğinde OAuth'u tercih edin. İstemcinizde başlık kimlik doğrulaması mevcutsa, X-API-Anahtarı bu da desteklenmektedir.

Gemini MCP belgeleri: Gemini CLI ile MCP sunucuları


MCP İstemcisi düğümünü (veya MCP İstemcisi Aracı düğümünü) kullanın:

  1. İş akışınıza bir MCP düğümü ekleyin.
  2. Sunucu URL'sini şu şekilde ayarlayın: https://app.winninghunter.com/mcp.
  3. Başlık yetkilendirmesini ekle: X-API-Anahtarı = senin wh_... anahtar.

n8n belgeleri: MCP İstemcisi


Elinize ne

Şu sorguyu çalıştırabilirsiniz:

  • TikTok Shop ürünleri, mağazalar, içerik üreticiler, videolar, kategoriler, trending
  • Meta reklam kütüphanesi araması
  • Marka takip listesi
  • Shopify mağaza araması
  • Popüler Konular arama + ayrıntılar
  • Kredi bakiyesi kontrolü

Tüm MCP araçları salt okunurdur.

Sık kullanılanları, ön ayarları, transkriptleri veya diğer yazıları kaydetmeniz gerekiyorsa, REST API'yi kullanın (/api/v1/tiktok-shop/*).


Krediler ve limitler (basit versiyon)

  • araçlar/çağrı başarı = 1 API kredisi
  • araçlar/liste ve bağlantı kontrolleri değil ücret
  • Doğrulama hatası/geçersiz kimlik bilgisi 401
  • Hesapta API erişimi yok 403

Tüm ayrıntılar: Ödeme ve faturalandırma, İstek sınırları, Sorun giderme


Sonraki

Araçların tam adlarını ve parametrelerini mi arıyorsunuz? Açın:

MCP araçları kılavuzu