suprsonic-mcp

resmi

Bir API anahtarı, AI ajanınız için düzinelerce yetenek. Sıfır sağlayıcı kimlik doğrulaması.

GitHub

Suprsonic MCP ile neler yapabilirsiniz?

Web’de arama yapın — Asistanın search kullanarak güncel bilgileri aramasını isteyin; yapay zeka ile sentezlenmiş sonuçlar veya ham SERP verisi seçenekleri mevcuttur.
Web sayfası içeriğini çıkarın — Herhangi bir URL’den scrape aracılığıyla temiz Markdown çıkarımı talep edin.
Profesyonel kişileri bulun — profiles ile profilleri arayın ve emails kullanarak e-posta adreslerini keşfedin.
Görseller ve konuşma oluşturun — images ile metin istemlerinden görseller oluşturun ve tts aracılığıyla metni sesli kayda dönüştürün.
Medyayı yazıya dökün ve altyazı ekleyin — stt veya transcribe (konuşmacı etiketleriyle) kullanarak ses dosyalarını yazıya dökün ve subtitle ile SRT/VTT altyazıları oluşturun.
Belgeleri ve dosyaları işleyin — documents ile URL’lerden yapılandırılmış veri çıkarın, invoice-parse ile faturaları ayrıştırın, file-convert ile 200’den fazla format arasında dönüşüm yapın ve screenshot ile web sayfası ekran görüntüleri alın.

Dokümantasyon

@suprsonic/mcp

Suprsonic için MCP sunucusu. Tek bir bağlantıyla herhangi bir yapay zeka ajanına düzinelerce yetenek kazandırır.

Hızlı Başlangıç

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

API anahtarınızı suprsonic.ai/app/apis adresinden alın.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "@suprsonic/mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Cursor / VS Code

.cursor/mcp.json veya VS Code MCP yapılandırmasına ekleyin:

{
  "suprsonic": {
    "command": "npx",
    "args": ["-y", "@suprsonic/mcp"],
    "env": {
      "SUPRSONIC_API_KEY": "omk_your_key"
    }
  }
}

Uzak HTTP (Claude API, ChatGPT, programatik ajanlar için)

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp --http --port 3100

Ardından http://localhost:3100/mcp adresine bağlanın.

Kullanılabilir Araçlar

Araç	Ne Yapar
search	Web'de arama yapın (AI sentezi, SERP veya her ikisi)
scrape	Herhangi bir URL'den içeriği Markdown olarak çıkarın
profiles	İsim veya LinkedIn URL'si ile profesyonel profilleri bulun
emails	Profesyonel e-posta adreslerini bulun
images	Metin komutlarından görseller oluşturun
tts	Metni konuşmaya dönüştürün
stt	Sesi metne dönüştürün
sms	SMS veya WhatsApp mesajları gönderin
documents	URL'lerden yapılandırılmış veri çıkarın
companies	Alan adına göre şirket verilerini sorgulayın
email-verify	Bir e-postanın teslim edilebilir olup olmadığını kontrol edin
transcribe	Konuşmacı etiketleriyle sesi yazıya dökün
invoice-parse	Faturalardan veri çıkarın
subtitle	SRT/VTT altyazıları oluşturun
file-convert	Dosyaları 200'den fazla format arasında dönüştürün
bg-remove	Görsel arka planlarını kaldırın
screenshot	Web sayfası ekran görüntüleri yakalayın

Yanıt Formatı

Her araç birleşik bir yanıt nesnesi döndürür:

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

Başarısızlık durumunda, success false olur ve error ayrıntıları içerir (aşağıya bakın).

Hata Yönetimi

Hata nesnesi yapısı (success false olduğunda döndürülür):

{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

Hata kategorileri: transient (yeniden denenebilir), permanent (hatalı istek), authentication (geçersiz anahtar), billing (kredi yetersiz).

MCP kullanırken, yapay zeka ajanı hata yanıtını alır ve is_retriable ile retry_after_seconds değerlerine göre yeniden deneyip denememeye karar verebilir.

Tüm parametreler ve örnek yanıtlarla birlikte tam API referansı: suprsonic.ai/apis