Superlines MCP server

Superlines MCP Server

Servidor Model Context Protocol (MCP) para análisis de visibilidad en IA de Superlines.

Conecta Claude Desktop, Cursor o cualquier cliente compatible con MCP a tus datos de Superlines.

Inicio rápido • Herramientas disponibles • Solución de problemas

---

¿Qué es esto?

Superlines rastrea cómo aparece tu marca en motores de búsqueda impulsados por IA como ChatGPT, Perplexity, Gemini y Claude. Este servidor MCP te permite consultar tus datos de análisis de Superlines directamente desde asistentes de IA.

Haz preguntas como:

• "¿Cuál es la visibilidad de mi marca este mes frente al mes pasado?"
• "¿Qué dominios se citan más en las respuestas de IA?"
• "Muéstrame mis principales competidores por cuota de voz"
• "Audita mi sitio web para verificar su compatibilidad con LLM"

Características

• 📊 Análisis de marca — Métricas de visibilidad, citas, cuota de voz
• 🏆 Análisis de competidores — Compara con competidores mediante análisis de sentimiento
• 🔗 Seguimiento de citas — Consulta qué URLs se citan en las respuestas de IA
• 📈 Análisis de tendencias — Tendencias de rendimiento semanales y mensuales
• 🔍 Auditoría de páginas web — Análisis de compatibilidad con LLM para cualquier URL
• 🛠️ Optimización de esquema — Genera marcado Schema.org optimizado

Requisitos previos

• Node.js 18+ instalado (Descargar)
• Cuenta de Superlines con plan Enterprise (el acceso a MCP es solo para Enterprise)
• Clave API desde tu panel de Superlines

---

Inicio rápido

Paso 1: Obtén tu clave API

1. Inicia sesión en analytics.superlines.io
2. Ve a Configuración de la organización → Claves API
3. Haz clic en "Crear nueva clave API"
4. Copia la clave (comienza con sl_live_) — ¡solo se muestra una vez!

Paso 2: Configura Claude Desktop

Edita tu archivo de configuración de Claude Desktop:

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

Añade esta configuración:

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

Importante: Reemplaza sl_live_YOUR_API_KEY con tu clave API real.

Paso 3: Reinicia Claude Desktop

1. Sal por completo: ⌘+Q en Mac, o haz clic derecho en el icono de la barra de tareas → Salir en Windows
2. Vuelve a abrir Claude Desktop
3. Verifica: Busca el icono de martillo (🔨) que indica que las herramientas MCP están disponibles

Paso 4: ¡Empieza a hacer preguntas!

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

Si prefieres no usar npx, puedes descargar y ejecutar el script de proxy localmente.

Descarga el 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"

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

Reemplaza YOUR_USERNAME con tu nombre de usuario real. Encuéntralo ejecutando echo $USER (macOS) o echo %USERNAME% (Windows).

---

Configuración para otros clientes MCP

Cursor

Añade a .cursor/mcp.json en tu proyecto o globalmente:

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

VS Code con Continue

Añade a tu configuración de Continue:

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

Instalación global (alternativa)

Si prefieres instalar globalmente en lugar de usar npx:

npm install -g @superlines/mcp-server

Luego usa esta configuración:

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

---

Herramientas disponibles

Análisis de marca

Herramienta	Descripción
list_brands	Lista todas las marcas a las que tienes acceso
get_brand_details	Obtén la configuración de marca, competidores e industria
analyze_metrics	Visibilidad de marca, tasa de citas, menciones, cuota de voz
get_weekly_performance	Tendencias de rendimiento semanales
get_period_comparison	Compara el período actual con el anterior
get_analytics_summary	Resumen de análisis de alto nivel

Citas

Herramienta	Descripción
get_citation_data	Análisis de citas de dominios y URLs
get_top_cited_url_per_prompt	URLs más citadas por consulta

Análisis de competidores

Herramienta	Descripción
analyze_brand_mentions	Menciones de competidores con puntuaciones de sentimiento
get_competitive_gap	Encuentra oportunidades competitivas
get_competitor_insights	Resumen completo de competidores
get_best_performing_prompt	Los prompts con mejor rendimiento

Estrategia de contenido

Herramienta	Descripción
get_query_data	Análisis de consultas con volúmenes de búsqueda
find_content_opportunities	Temas con potencial de mejora
get_fanout_query_insights	Análisis de consultas de fuentes LLM
analyze_sentiment	Análisis de sentimiento de respuestas de IA

Análisis de páginas web

Herramienta	Descripción
webpage_crawl	Obtén y analiza el contenido de páginas web
webpage_audit	Auditoría completa de compatibilidad con LLM
webpage_analyze_technical	Análisis técnico de SEO
webpage_analyze_content	Análisis de calidad de contenido
schema_optimizer	Optimiza el marcado Schema.org
analyze_competitor_url	Análisis en profundidad de URLs de competidores

---

Variables de entorno

Variable	Requerida	Descripción
SUPERLINES_API_KEY	Sí	Tu clave API de Superlines (comienza con sl_live_)
MCP_SERVER_URL	No	Anula la URL del servidor predeterminada
DEBUG	No	Establécelo en true para registro de depuración

---

Consultas de ejemplo

Análisis de rendimiento

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

Inteligencia de competidores

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

Análisis de citas

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

Tendencias semanales

Show me weekly performance for the last 8 weeks

Auditoría de páginas web

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

Oportunidades de contenido

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

---

Solución de problemas

"Variable de entorno SUPERLINES_API_KEY no configurada"

Asegúrate de que tu configuración incluya la sección env con tu clave API:

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

"401 No autorizado"

• Tu clave API no es válida o ha caducado
• Genera una nueva clave en Configuración de la organización → Claves API

"403 Prohibido"

• El acceso a la API requiere un plan Enterprise
• Contacta con support@superlines.io para actualizar

Claude dice "no tengo acceso a ninguna herramienta"

1. Reinicia Claude Desktop por completo (⌘+Q en Mac, no solo cierres la ventana)
2. Comprueba la ruta del script — usa la ruta absoluta completa, no ~
3. Valida que tu configuración sea JSON válido:

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

4. Prueba el 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
   

   Deberías ver una respuesta JSON que enumera las herramientas disponibles.

Script no encontrado

• Usa la ruta absoluta completa en tu configuración
• ✅ Bien: /Users/john/superlines-mcp/mcp-proxy.js
• ❌ Mal: ~/superlines-mcp/mcp-proxy.js
• Windows: Usa dobles barras invertidas: C:\\Users\\john\\...

---

Seguridad

• 🔒 Nunca compartas tu clave API públicamente
• 🔒 No confirmes claude_desktop_config.json en el control de versiones
• 🔒 Rota las claves regularmente en Configuración de la organización
• 🔒 Revoca las claves inmediatamente si se ven comprometidas

Asegura tu archivo de configuración:

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

---

Aviso de beta

⚠️ El servidor MCP de Superlines se encuentra actualmente en beta y puede experimentar inestabilidad o contener errores. Informa de los problemas en github.com/Superlines/mcp-server/issues.

---

Recursos

• Panel de Superlines
• Documentación de la API
• Especificación del protocolo MCP
• Claude Desktop

Soporte

• Correo electrónico: support@superlines.io
• Problemas: github.com/Superlines/mcp-server/issues

---

Licencia

MIT © Superlines