suprsonic-mcp

resmi

Satu kunci API, puluhan kemampuan untuk agen AI Anda. Tanpa autentikasi penyedia.

GitHub

Apa yang bisa Anda lakukan dengan Suprsonic MCP?

Cari di web — Minta asisten untuk mencari informasi terkini menggunakan search, dengan opsi hasil sintesis AI atau data SERP mentah.
Ekstrak konten halaman web — Minta ekstraksi Markdown bersih dari URL mana pun melalui scrape.
Temukan kontak profesional — Cari profil dengan profiles dan temukan alamat email menggunakan emails.
Hasilkan gambar dan ucapan — Buat gambar dari perintah teks dengan images dan ubah teks menjadi audio ucapan melalui tts.
Transkripsi dan subtitle media — Transkripsikan file audio menggunakan stt atau transcribe (dengan label pembicara), dan hasilkan subtitle SRT/VTT dengan subtitle.
Proses dokumen dan file — Ekstrak data terstruktur dari URL dengan documents, parsing faktur melalui invoice-parse, konversi antara 200+ format menggunakan file-convert, dan ambil tangkapan layar halaman web dengan screenshot.

Dokumentasi

@suprsonic/mcp

Server MCP untuk Suprsonic. Memberikan puluhan kemampuan kepada agen AI mana pun melalui satu koneksi.

Mulai Cepat

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Dapatkan kunci API Anda di suprsonic.ai/app/apis.

Claude Desktop

Tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor / VS Code

Tambahkan ke .cursor/mcp.json atau konfigurasi MCP VS Code:

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

HTTP Jarak Jauh (untuk Claude API, ChatGPT, agen terprogram)

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

Lalu sambungkan ke http://localhost:3100/mcp.

Alat yang Tersedia

Alat	Fungsinya
search	Cari di web (sintesis AI, SERP, atau keduanya)
scrape	Ekstrak konten dari URL apa pun sebagai Markdown
profiles	Temukan profil profesional berdasarkan nama atau URL LinkedIn
emails	Temukan alamat email profesional
images	Hasilkan gambar dari perintah teks
tts	Ubah teks menjadi ucapan
stt	Transkripsi audio menjadi teks
sms	Kirim pesan SMS atau WhatsApp
documents	Ekstrak data terstruktur dari URL
companies	Cari data perusahaan berdasarkan domain
email-verify	Periksa apakah email dapat terkirim
transcribe	Transkripsi audio dengan label pembicara
invoice-parse	Ekstrak data dari faktur
subtitle	Hasilkan subtitle SRT/VTT
file-convert	Konversi file antara 200+ format
bg-remove	Hapus latar belakang gambar
screenshot	Tangkap tangkapan layar halaman web

Format Respons

Setiap alat mengembalikan objek respons terpadu:

{
  "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
}

Saat gagal, success adalah false dan error berisi detailnya (lihat di bawah).

Penanganan Kesalahan

Struktur objek kesalahan (dikembalikan saat success adalah false):

{
  "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"
}

Kategori kesalahan: transient (aman untuk dicoba ulang), permanent (permintaan buruk), authentication (kunci tidak valid), billing (kredit habis).

Saat menggunakan MCP, agen AI menerima kesalahan dalam respons alat dan dapat memutuskan apakah akan mencoba ulang berdasarkan is_retriable dan retry_after_seconds.

Referensi API lengkap dengan semua parameter dan contoh respons: suprsonic.ai/apis