suprsonic-mcp

oficial

Uma chave de API, dezenas de capacidades para seu agente de IA. Zero autenticação de provedor.

GitHub

O que você pode fazer com Suprsonic MCP?

Pesquisar na web — Peça ao assistente para buscar informações atuais usando search, com opções para resultados sintetizados por IA ou dados brutos de SERP.
Extrair conteúdo de página web — Solicite a extração limpa em Markdown de qualquer URL via scrape.
Encontrar contatos profissionais — Consulte perfis com profiles e descubra endereços de e-mail usando emails.
Gerar imagens e fala — Crie imagens a partir de prompts de texto com images e converta texto em áudio falado via tts.
Transcrever e legendar mídia — Transcreva arquivos de áudio usando stt ou transcribe (com identificação de falantes) e gere legendas SRT/VTT com subtitle.
Processar documentos e arquivos — Extraia dados estruturados de URLs com documents, analise faturas via invoice-parse, converta entre mais de 200 formatos usando file-convert e capture capturas de tela de páginas web com screenshot.

Documentação

@suprsonic/mcp

Servidor MCP para Suprsonic. Oferece a qualquer agente de IA dezenas de funcionalidades através de uma única conexão.

Início Rápido

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Obtenha sua chave de API em suprsonic.ai/app/apis.

Claude Desktop

Adicione ao ~/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

Adicione ao .cursor/mcp.json ou à configuração MCP do VS Code:

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

HTTP Remoto (para Claude API, ChatGPT, agentes programáticos)

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

Em seguida, conecte-se a http://localhost:3100/mcp.

Ferramentas Disponíveis

Ferramenta	O que faz
search	Pesquisa na web (síntese de IA, SERP ou ambos)
scrape	Extrai conteúdo de qualquer URL como Markdown
profiles	Encontra perfis profissionais por nome ou URL do LinkedIn
emails	Encontra endereços de e-mail profissionais
images	Gera imagens a partir de prompts de texto
tts	Converte texto em fala
stt	Transcreve áudio para texto
sms	Envia mensagens SMS ou WhatsApp
documents	Extrai dados estruturados de URLs
companies	Consulta dados de empresas por domínio
email-verify	Verifica se um e-mail é entregável
transcribe	Transcreve áudio com identificação de locutores
invoice-parse	Extrai dados de faturas
subtitle	Gera legendas SRT/VTT
file-convert	Converte arquivos entre mais de 200 formatos
bg-remove	Remove fundos de imagens
screenshot	Captura capturas de tela de páginas web

Formato de Resposta

Toda ferramenta retorna um objeto de resposta unificado:

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

Em caso de falha, success é false e error contém os detalhes (veja abaixo).

Tratamento de Erros

Estrutura do objeto de erro (retornado quando success é 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"
}

Categorias de erro: transient (seguro para repetir), permanent (requisição inválida), authentication (chave inválida), billing (sem créditos).

Ao usar MCP, o agente de IA recebe o erro na resposta da ferramenta e pode decidir se deve tentar novamente com base em is_retriable e retry_after_seconds.

Referência completa da API com todos os parâmetros e exemplos de resposta: suprsonic.ai/apis