Servidor MCP de SurfRank

Permite que tu agente de IA ejecute informes de visibilidad de IA, investigue palabras clave y rastree competidores en SurfRank, directamente desde la ventana de chat.

Este paquete expone la API pública de SurfRank como herramientas del Protocolo de Contexto de Modelo (MCP), para que cualquier asistente de IA compatible con MCP — Claude Desktop, Claude Code, Cursor, Windsurf, conectores MCP de ChatGPT, y otros — pueda llamar a SurfRank en tu nombre.

¿Qué es SurfRank?

SurfRank mide qué tan visible es tu marca dentro de las respuestas de la IA (ChatGPT, Perplexity, Gemini, Claude, Grok, DeepSeek, Meta AI). Ejecuta tus palabras clave rastreadas contra cada motor, califica tus menciones frente a la competencia y muestra las oportunidades de contenido que marcarían la diferencia.

Related MCP server: DataForSEO MCP Server

¿Qué es MCP?

El Protocolo de Contexto de Modelo (Model Context Protocol) es un estándar abierto de Anthropic que permite a los agentes de IA descubrir y llamar a herramientas externas. Instala este servidor una vez y tu agente obtendrá 24 nuevas capacidades: sin APIs de plugins, sin líos de OAuth, sin código de integración.

Qué puedes pedirle a tu agente una vez conectado

💬 "Crea un proyecto de SurfRank para surfrank.ai en la industria SaaS, luego rastrea estas 10 palabras clave…"

💬 "¿Qué mostró mi último informe de visibilidad de IA? ¿Qué motores no incluyen mi marca?"

💬 "Ejecuta una prueba rápida para competitor.com y compárala con mi puntuación."

💬 "Enumera mis 5 mejores oportunidades de contenido y redacta artículos para las de mayor impacto."

El agente elige la herramienta correcta, llama a la API de SurfRank con tu clave y responde en lenguaje natural. Los créditos se descuentan de tu cuenta de SurfRank a la misma tasa que las llamadas directas a la API.

Requisitos

• Node.js 18 o superior (requerido por el SDK de MCP).

• Una clave de API de SurfRank en el plan Pay As You Go. Genera una en app.surfrank.ai/api-management.

• Un cliente compatible con MCP (consulta la sección de Configuración).

Instalación

Ejecuta de forma puntual con npx: no se requiere instalación:

npx -y @surfrank/mcp-server

O instálalo globalmente:

npm install -g @surfrank/mcp-server

Configuración

Elige tu cliente a continuación y pega el fragmento en su archivo de configuración MCP.

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

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver aparecer surfrank en el menú de servidores MCP.

Cursor

Edita ~/.cursor/mcp.json (o usa Settings → MCP → Add server):

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add surfrank -- npx -y @surfrank/mcp-server
export SURFRANK_API_KEY=sr_your_key_here

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

Herramientas disponibles

El servidor expone cada endpoint de la API pública de SurfRank como una herramienta (24 en total). Tu agente los descubre automáticamente; no necesitas enumerarlos en tu prompt.

Cada herramienta se asigna 1:1 a un endpoint REST bajo https://api.surfrank.ai/api/v1/public/*.

Claves de API con alcance limitado

Si generas una clave de API con alcance de proyecto, el servidor MCP solo podrá operar en ese proyecto. Cualquier llamada a una herramienta que haga referencia a un ID de proyecto diferente será rechazada con un 403 por la API de SurfRank, y el error aparecerá textualmente en la respuesta del agente.

Esta es la configuración recomendada cuando conectas un solo espacio de trabajo o un compañero de equipo a una sola marca.

Uso de créditos

Los créditos se descuentan de tu cuenta de SurfRank según la misma tarifa que las llamadas directas a la API:

Cada respuesta de herramienta incluye un objeto credits para que tu agente (y tú) puedan realizar un seguimiento del uso en tiempo real.

Variables de entorno

Depuración

Usa el inspector oficial de MCP para probar el servidor directamente; es útil al configurar un nuevo cliente o diagnosticar un problema de conexión:

SURFRANK_API_KEY=sr_your_key_here \
  npx @modelcontextprotocol/inspector npx @surfrank/mcp-server

El inspector abre una interfaz de navegador donde puedes listar herramientas y llamarlas manualmente, exactamente como lo haría un agente de IA.

Notas de seguridad

• Las claves de API se muestran una vez al crearlas y se almacenan como hashes SHA-256 en los servidores de SurfRank. Si pierdes una clave, revócala y genera una nueva; no se puede recuperar.

• Las credenciales permanecen en tu archivo de configuración local de MCP. Este paquete nunca las escribe en el disco y nunca envía datos a servidores externos.

• Cada clave de API tiene un límite de velocidad de 60 solicitudes por minuto. Excederlo devuelve un HTTP 429.

Enlaces

• 🌐 SurfRank — surfrank.ai

• 🔑 Gestión de API — app.surfrank.ai/api-management

• 📘 Documentación de la API pública — en la pestaña API Management → Documentation

• 🐛 Problemas — github.com/SurfRankAI/mcp-server/issues

• 📦 npm — @surfrank/mcp-server

Licencia

MIT © SurfRank Pte. Ltd. — consulta LICENSE.