suprsonic-mcp

officiel

Une clé API, des dizaines de capacités pour votre agent IA. Zéro authentification fournisseur.

GitHub

Que pouvez-vous faire avec Suprsonic MCP ?

Rechercher sur le web — Demandez à l'assistant de rechercher des informations actuelles à l'aide de search, avec des options pour des résultats synthétisés par IA ou des données SERP brutes.
Extraire le contenu d'une page web — Demandez une extraction propre en Markdown depuis n'importe quelle URL via scrape.
Trouver des contacts professionnels — Consultez des profils avec profiles et découvrez des adresses e-mail à l'aide de emails.
Générer des images et de la parole — Créez des images à partir de descriptions textuelles avec images et convertissez du texte en audio parlé via tts.
Transcrire et sous-titrer des médias — Transcrivez des fichiers audio à l'aide de stt ou transcribe (avec identification des locuteurs), et générez des sous-titres SRT/VTT avec subtitle.
Traiter des documents et fichiers — Extrayez des données structurées d'URL avec documents, analysez des factures via invoice-parse, convertissez entre plus de 200 formats à l'aide de file-convert, et capturez des captures d'écran de pages web avec screenshot.

Documentation

@suprsonic/mcp

Serveur MCP pour Suprsonic. Offre à tout agent IA des dizaines de capacités via une seule connexion.

Démarrage rapide

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Obtenez votre clé API sur suprsonic.ai/app/apis.

Claude Desktop

Ajoutez à ~/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

Ajoutez à .cursor/mcp.json ou à la configuration MCP de VS Code :

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

HTTP distant (pour Claude API, ChatGPT, agents programmatiques)

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

Connectez-vous ensuite à http://localhost:3100/mcp.

Outils disponibles

Outil	Ce qu'il fait
search	Rechercher sur le web (synthèse IA, SERP, ou les deux)
scrape	Extraire le contenu de n'importe quelle URL en Markdown
profiles	Trouver des profils professionnels par nom ou URL LinkedIn
emails	Trouver des adresses email professionnelles
images	Générer des images à partir de descriptions textuelles
tts	Convertir du texte en parole
stt	Transcrire de l'audio en texte
sms	Envoyer des SMS ou des messages WhatsApp
documents	Extraire des données structurées depuis des URLs
companies	Rechercher des données d'entreprise par domaine
email-verify	Vérifier si un email est distribuable
transcribe	Transcrire de l'audio avec étiquettes de locuteur
invoice-parse	Extraire des données de factures
subtitle	Générer des sous-titres SRT/VTT
file-convert	Convertir des fichiers entre plus de 200 formats
bg-remove	Supprimer l'arrière-plan des images
screenshot	Capturer des captures d'écran de pages web

Format de réponse

Chaque outil retourne un objet de réponse unifié :

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

En cas d'échec, success est false et error contient les détails (voir ci-dessous).

Gestion des erreurs

Structure de l'objet d'erreur (retourné lorsque success est 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"
}

Catégories d'erreur : transient (réessayer sans risque), permanent (mauvaise requête), authentication (clé invalide), billing (crédits épuisés).

Lors de l'utilisation de MCP, l'agent IA reçoit l'erreur dans la réponse de l'outil et peut décider de réessayer en fonction de is_retriable et retry_after_seconds.

Référence API complète avec tous les paramètres et exemples de réponses : suprsonic.ai/apis