suprsonic-mcp

offiziell

Ein API-Schlüssel, Dutzende Fähigkeiten für Ihren KI-Agenten. Keine Anbieter-Authentifizierung.

GitHub

Was kann man mit Suprsonic MCP machen?

Web durchsuchen — Bitten Sie den Assistenten, aktuelle Informationen mit search zu suchen, mit Optionen für KI-synthetisierte Ergebnisse oder rohe SERP-Daten.
Webseiteninhalte extrahieren — Fordern Sie eine saubere Markdown-Extraktion von jeder URL über scrape an.
Professionelle Kontakte finden — Suchen Sie Profile mit profiles und entdecken Sie E-Mail-Adressen mit emails.
Bilder und Sprache generieren — Erstellen Sie Bilder aus Textvorgaben mit images und wandeln Sie Text über tts in gesprochenes Audio um.
Medien transkribieren und untertiteln — Transkribieren Sie Audiodateien mit stt oder transcribe (mit Sprecherkennung) und generieren Sie SRT/VTT-Untertitel mit subtitle.
Dokumente und Dateien verarbeiten — Extrahieren Sie strukturierte Daten aus URLs mit documents, parsen Sie Rechnungen über invoice-parse, konvertieren Sie zwischen über 200 Formaten mit file-convert und erstellen Sie Webseiten-Screenshots mit screenshot.

Dokumentation

@suprsonic/mcp

MCP-Server für Suprsonic. Verleiht jedem KI-Agenten dutzende Fähigkeiten über eine einzige Verbindung.

Schnellstart

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Holen Sie sich Ihren API-Schlüssel unter suprsonic.ai/app/apis.

Claude Desktop

Zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzufügen:

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

Cursor / VS Code

Zu .cursor/mcp.json oder der VS Code MCP-Konfiguration hinzufügen:

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

Remote HTTP (für Claude API, ChatGPT, programmatische Agenten)

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

Dann mit http://localhost:3100/mcp verbinden.

Verfügbare Werkzeuge

Werkzeug	Funktion
search	Das Web durchsuchen (KI-Synthese, SERP oder beides)
scrape	Inhalte von beliebigen URLs als Markdown extrahieren
profiles	Berufliche Profile anhand von Name oder LinkedIn-URL finden
emails	Berufliche E-Mail-Adressen finden
images	Bilder aus Textbeschreibungen generieren
tts	Text in Sprache umwandeln
stt	Audio in Text transkribieren
sms	SMS- oder WhatsApp-Nachrichten senden
documents	Strukturierte Daten aus URLs extrahieren
companies	Unternehmensdaten anhand der Domain abrufen
email-verify	Zustellbarkeit einer E-Mail prüfen
transcribe	Audio mit Sprecherkennzeichnung transkribieren
invoice-parse	Daten aus Rechnungen extrahieren
subtitle	SRT/VTT-Untertitel generieren
file-convert	Dateien zwischen über 200 Formaten konvertieren
bg-remove	Bildhintergründe entfernen
screenshot	Webseiten-Screenshots aufnehmen

Antwortformat

Jedes Werkzeug gibt ein einheitliches Antwortobjekt zurück:

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

Bei Fehlschlag ist success gleich false und error enthält die Details (siehe unten).

Fehlerbehandlung

Struktur des Fehlerobjekts (wird zurückgegeben, wenn success gleich false ist):

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

Fehlerkategorien: transient (Wiederholung sicher), permanent (fehlerhafte Anfrage), authentication (ungültiger Schlüssel), billing (kein Guthaben mehr).

Bei Verwendung von MCP erhält der KI-Agent den Fehler in der Werkzeugantwort und kann anhand von is_retriable und retry_after_seconds entscheiden, ob ein erneuter Versuch sinnvoll ist.

Vollständige API-Referenz mit allen Parametern und Beispielantworten: suprsonic.ai/apis