GeoRanker

Accede a las herramientas de SEO e investigación de palabras clave de GeoRanker para un análisis avanzado de optimización en motores de búsqueda.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP GeoRanker (Optimizado para Agentes de IA)

Un servidor amigable para agentes del Protocolo de Contexto de Modelo (MCP) para la API de Alto Volumen de GeoRanker.

Este servidor se centra en:

Salidas de herramientas compactas y estructuradas (sin "resúmenes" de LLM: vistas previas deterministas + truncamiento)
Cargas útiles grandes mediante recursos (JSON sin procesar disponible a través de recursos georanker://… en lugar de inflar las salidas de las herramientas)
Soporte multitransporte
- stdio (Claude Desktop, clientes MCP locales)
- Streamable HTTP (recomendado para Cursor, OpenAI Remote MCP, uso alojado)
- HTTP+SSE obsoleto (compatibilidad opcional para clientes antiguos)
Exportación OpenAPI para clientes que no son MCP (p. ej., OpenAI Actions / herramientas HTTP genéricas)
Descubrimiento compatible con Smithery mediante /.well-known/mcp/server-card.json

Novedades frente a versiones anteriores

Salida optimizada para agentes

Las respuestas de las herramientas ahora son:

Con forma determinista (vistas previas top-N, campos clave extraídos)
Truncadas de forma segura (límites de cadena/arreglo/objeto)
Estructuradas (salida JSON + structuredContent)
Datos sin procesar accesibles bajo demanda mediante recursos como:
- georanker://serp/{id}
- georanker://keywords/{id}
- georanker://regions

Multiplataforma

Ejecute el mismo servidor para:

Claude Desktop (stdio)
Cursor (Streamable HTTP)
OpenAI Remote MCP (Streamable HTTP o HTTP+SSE)
LangChain / cualquier aplicación Node (mediante cliente MCP O endpoints OpenAPI)

Instalación

npm i -g georanker-mcp
# or run without install:
npx georanker-mcp --help

Configuración

Variables de entorno

GEORANKER_API_KEY=your_key_here
GEORANKER_API_BASE_URL=https://api.highvolume.georanker_com

# Optional tuning
GR_OUTPUT_MODE=compact          # compact | standard | raw
GR_MAX_PREVIEW_ITEMS=10
GR_MAX_STRING_CHARS=800

# HTTP mode
MCP_TRANSPORT=http              # http | stdio
MCP_HOST=127.0.0.1
MCP_PORT=3333
MCP_PATH=/mcp
MCP_ENABLE_DEPRECATED_SSE=true  # enables /sse + /messages
MCP_AUTH_TOKEN=                 # optional bearer token
MCP_PUBLIC_URL=                 # optional public https url used in server card/openapi

Banderas de CLI (anulan variables de entorno)

georanker-mcp --apikey YOUR_KEY
georanker-mcp --transport http --host 127.0.0.1 --port 3333 --path /mcp
georanker-mcp --transport http --auth-token mysecret
georanker-mcp --legacy   # expose deprecated snake_case tool names

Ejecución

1) Modo stdio (Claude Desktop / local)

GEORANKER_API_KEY=... georanker-mcp

2) Modo HTTP (recomendado para Cursor / alojado)

GEORANKER_API_KEY=... georanker-mcp --transport http --port 3333

Endpoints:

MCP Streamable HTTP: http://127.0.0.1:3333/mcp
SSE obsoleto: http://127.0.0.1:3333/sse (y POST /messages)
OpenAPI: http://127.0.0.1:3333/openapi.json
Tarjeta de servidor: http://127.0.0.1:3333/.well-known/mcp/server-card.json

Destinos de integración

Claude Desktop (stdio)

Añada a su configuración de Claude Desktop:

{
  "mcpServers": {
    "georanker": {
      "command": "npx",
      "args": ["-y", "georanker-mcp"],
      "env": {
        "GEORANKER_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Cursor (Streamable HTTP)

Ejecute el servidor en modo HTTP (--transport http)
En Cursor, añada un servidor MCP con URL:
- http://127.0.0.1:3333/mcp (local)
- o su URL HTTPS desplegada para uso alojado

OpenAI (Remote MCP)

Implemente el servidor HTTP en una URL HTTPS pública y luego configure una herramienta MCP remota que apunte a:

https://your-host/mcp (Streamable HTTP)
o https://your-host/sse (HTTP+SSE obsoleto)

LangChain / aplicaciones Node

Opción A: use un cliente MCP para conectarse al endpoint MCP. Opción B: llame a los endpoints OpenAPI bajo /api/v1/*.

Nombres de herramientas (nuevos)

Los nombres de herramientas recomendados tienen espacio de nombres:

georanker_serp.create
georanker_serp.get
georanker_serp.delete
georanker_serp.batch_create
georanker_serp.batch_get
georanker_serp.compare_locations
georanker_keywords.create
georanker_keywords.get
georanker_keywords.delete
georanker_keywords.batch_create
georanker_keywords.batch_get
georanker_keywords.suggest
georanker_domain.whois
georanker_domain.technologies
georanker_regions.list
georanker_account.get
georanker_health.check

Nombres de herramientas heredados

Establezca GR_ENABLE_LEGACY_TOOL_NAMES=true o ejecute con --legacy para exponer también las antiguas herramientas snake_case.

Formato de salida

Todas las herramientas devuelven JSON compacto con la siguiente forma:

{
  "ok": true,
  "action": "georanker_serp.get",
  "generated_at": "2026-02-19T12:00:00.000Z",
  "request": { "id": "..." },
  "data": { "...compact preview..." },
  "links": { "raw_resource": "georanker://serp/..." }
}

Si una herramienta falla, devuelve ok:false y el resultado de la herramienta MCP incluirá isError:true.

Publicación

npm

Compile:
```
npm run build
```
Inicie sesión:
```
npm login
```
Publique:
```
npm publish --access public
```

Registro MCP de Smithery

Publicación por URL (recomendada para servidores alojados):

Asegúrese de que Streamable HTTP esté disponible en /mcp
Asegúrese de que la tarjeta de servidor exista en /.well-known/mcp/server-card.json

Luego publique desde la interfaz de Smithery o mediante CLI:

smithery mcp publish "https://your-host/mcp" -n @lucas111112/georanker-mcp

Publicación local (stdio):

smithery mcp publish --name @lucas111112/georanker-mcp --transport stdio

Licencia

MIT