Superlines MCP server

Superlines MCP Server

Servidor Model Context Protocol (MCP) para análise de visibilidade em IA da Superlines.

Conecte o Claude Desktop, Cursor ou qualquer cliente compatível com MCP aos seus dados da Superlines.

Início Rápido • Ferramentas Disponíveis • Solução de Problemas

---

O que é isso?

A Superlines rastreia como sua marca aparece em mecanismos de busca com IA, como ChatGPT, Perplexity, Gemini e Claude. Este servidor MCP permite consultar seus dados de análise da Superlines diretamente de assistentes de IA.

Faça perguntas como:

• "Qual é a visibilidade da minha marca este mês em comparação com o mês passado?"
• "Quais domínios estão sendo mais citados nas respostas de IA?"
• "Mostre meus principais concorrentes por participação de voz"
• "Audite meu site para compatibilidade com LLM"

Recursos

• 📊 Análise de Marca — Métricas de visibilidade, citações, participação de voz
• 🏆 Análise de Concorrência — Compare com concorrentes com análise de sentimento
• 🔗 Rastreamento de Citações — Veja quais URLs são citadas nas respostas de IA
• 📈 Análise de Tendências — Tendências de desempenho semanais e mensais
• 🔍 Auditoria de Páginas Web — Análise de compatibilidade com LLM para qualquer URL
• 🛠️ Otimização de Schema — Gere marcação Schema.org otimizada

Pré-requisitos

• Node.js 18+ instalado (Baixar)
• Conta Superlines com plano Enterprise (acesso MCP é exclusivo para Enterprise)
• Chave de API do seu painel Superlines

---

Início Rápido

Passo 1: Obtenha sua Chave de API

1. Faça login em analytics.superlines.io
2. Vá para Configurações da Organização → Chaves de API
3. Clique em "Criar Nova Chave de API"
4. Copie a chave (começa com sl_live_) — ela só é exibida uma vez!

Passo 2: Configure o Claude Desktop

Edite o arquivo de configuração do seu Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione esta configuração:

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Importante: Substitua sl_live_YOUR_API_KEY pela sua chave de API real.

Passo 3: Reinicie o Claude Desktop

1. Saia completamente: ⌘+Q no Mac, ou clique com o botão direito no ícone da barra de tarefas → Sair no Windows
2. Reabra o Claude Desktop
3. Verifique: Procure o ícone de martelo (🔨) indicando que as ferramentas MCP estão disponíveis

Passo 4: Comece a Fazer Perguntas!

What brands do I have access to in Superlines?

Show me my brand visibility for the last 30 days

Audit https://example.com for LLM-friendliness

---

Alternativa: Script de Proxy Local

Se preferir não usar npx, você pode baixar e executar o script de proxy localmente.

Baixe o Script de Proxy

macOS / Linux:

mkdir -p ~/superlines-mcp
curl -o ~/superlines-mcp/mcp-proxy.js https://raw.githubusercontent.com/Superlines/mcp-server/main/mcp-proxy.js
chmod +x ~/superlines-mcp/mcp-proxy.js

Windows (PowerShell):

mkdir $env:USERPROFILE\superlines-mcp
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Superlines/mcp-server/main/mcp-proxy.js" -OutFile "$env:USERPROFILE\superlines-mcp\mcp-proxy.js"

Configure o Claude Desktop (Proxy Local)

macOS:

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/superlines-mcp/mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\superlines-mcp\\mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Substitua YOUR_USERNAME pelo seu nome de usuário real. Encontre-o executando echo $USER (macOS) ou echo %USERNAME% (Windows).

---

Configuração para Outros Clientes MCP

Cursor

Adicione a .cursor/mcp.json no seu projeto ou globalmente:

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code com Continue

Adicione à sua configuração do Continue:

{
  "mcpServers": [
    {
      "name": "superlines",
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  ]
}

Instalação Global (Alternativa)

Se preferir instalar globalmente em vez de usar npx:

npm install -g @superlines/mcp-server

Em seguida, use esta configuração:

{
  "mcpServers": {
    "superlines": {
      "command": "superlines-mcp",
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

---

Ferramentas Disponíveis

Análise de Marca

Ferramenta	Descrição
list_brands	Liste todas as marcas às quais você tem acesso
get_brand_details	Obtenha configuração da marca, concorrentes e setor
analyze_metrics	Visibilidade da marca, taxa de citação, menções, participação de voz
get_weekly_performance	Tendências de desempenho semanais
get_period_comparison	Compare o período atual com o anterior
get_analytics_summary	Visão geral de análises de alto nível

Citações

Ferramenta	Descrição
get_citation_data	Análise de citações de domínio e URL
get_top_cited_url_per_prompt	URLs mais citadas por consulta

Análise de Concorrência

Ferramenta	Descrição
analyze_brand_mentions	Menções de concorrentes com pontuações de sentimento
get_competitive_gap	Encontre oportunidades competitivas
get_competitor_insights	Visão geral abrangente de concorrentes
get_best_performing_prompt	Prompts com melhor desempenho

Estratégia de Conteúdo

Ferramenta	Descrição
get_query_data	Análise de consultas com volumes de busca
find_content_opportunities	Tópicos com potencial de melhoria
get_fanout_query_insights	Análise de consultas de fontes LLM
analyze_sentiment	Análise de sentimento das respostas de IA

Análise de Página Web

Ferramenta	Descrição
webpage_crawl	Buscar e analisar conteúdo de página web
webpage_audit	Auditoria completa de compatibilidade com LLM
webpage_analyze_technical	Análise técnica de SEO
webpage_analyze_content	Análise de qualidade de conteúdo
schema_optimizer	Otimize a marcação Schema.org
analyze_competitor_url	Análise aprofundada de URLs de concorrentes

---

Variáveis de Ambiente

Variável	Obrigatória	Descrição
SUPERLINES_API_KEY	Sim	Sua chave de API da Superlines (começa com sl_live_)
MCP_SERVER_URL	Não	Substitua a URL padrão do servidor
DEBUG	Não	Defina como true para registro de depuração

---

Exemplos de Consultas

Análise de Desempenho

Show me brand visibility and citations for the last 30 days, grouped by LLM service

Inteligência de Concorrência

Who are my top 10 competitors by mentions? Show sentiment breakdown.

Análise de Citações

Which domains are cited most in AI responses about my industry?

Tendências Semanais

Show me weekly performance for the last 8 weeks

Auditoria de Página Web

Audit https://competitor.com for LLM-friendliness and show me what schemas they use

Oportunidades de Conteúdo

What content should I create to improve my AI search visibility?

---

Solução de Problemas

"Variável de ambiente SUPERLINES_API_KEY não definida"

Certifique-se de que sua configuração inclua a seção env com sua chave de API:

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["/path/to/mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

"401 Não Autorizado"

• Sua chave de API é inválida ou expirou
• Gere uma nova chave em Configurações da Organização → Chaves de API

"403 Proibido"

• O acesso à API requer um plano Enterprise
• Entre em contato com support@superlines.io para fazer upgrade

O Claude diz "Não tenho acesso a nenhuma ferramenta"

1. Reinicie o Claude Desktop completamente (⌘+Q no Mac, não apenas feche a janela)
2. Verifique o caminho do script — use o caminho absoluto completo, não ~
3. Valide se sua configuração é JSON válido:

   cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool
   

4. Teste o proxy manualmente:

   export SUPERLINES_API_KEY="sl_live_your_key"
   echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node ~/superlines-mcp/mcp-proxy.js
   

   Você deve ver uma resposta JSON listando as ferramentas disponíveis.

Script não encontrado

• Use o caminho absoluto completo na sua configuração
• ✅ Bom: /Users/john/superlines-mcp/mcp-proxy.js
• ❌ Ruim: ~/superlines-mcp/mcp-proxy.js
• Windows: Use barras invertidas duplas: C:\\Users\\john\\...

---

Segurança

• 🔒 Nunca compartilhe sua chave de API publicamente
• 🔒 Não envie claude_desktop_config.json para controle de versão
• 🔒 Gire as chaves regularmente em Configurações da Organização
• 🔒 Revogue as chaves imediatamente se comprometidas

Proteja seu arquivo de configuração:

chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json

---

Aviso Beta

⚠️ O servidor MCP da Superlines está atualmente em beta e pode apresentar instabilidade ou conter bugs. Relate problemas em github.com/Superlines/mcp-server/issues.

---

Recursos

• Painel Superlines
• Documentação da API
• Especificação do Protocolo MCP
• Claude Desktop

Suporte

• E-mail: support@superlines.io
• Problemas: github.com/Superlines/mcp-server/issues

---

Licença

MIT © Superlines