GeoRanker

Acesse as ferramentas de SEO e pesquisa de palavras-chave da GeoRanker para análise avançada de otimização para mecanismos de busca.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP GeoRanker (Otimizado para Agentes de IA)

Um servidor Model Context Protocol (MCP) amigável para agentes para a API de Alto Volume do GeoRanker.

Este servidor tem foco em:

Saídas de ferramentas compactas e estruturadas (sem "resumos" de LLM — prévias determinísticas + truncamento)
Cargas grandes via recursos (JSON bruto disponível por meio de recursos georanker://… em vez de inflar as saídas das ferramentas)
Suporte a múltiplos transportes
- stdio (Claude Desktop, clientes MCP locais)
- HTTP Streamable (recomendado para Cursor, OpenAI Remote MCP, uso hospedado)
- HTTP+SSE obsoleto (compatibilidade opcional para clientes mais antigos)
Exportação OpenAPI para clientes não-MCP (ex.: OpenAI Actions / ferramentas HTTP genéricas)
Descoberta compatível com Smithery via /.well-known/mcp/server-card.json

Novidades em relação às versões anteriores

Saída otimizada para agentes

As respostas das ferramentas agora são:

Formatadas de forma determinística (prévias top-N, campos-chave extraídos)
Truncadas com segurança (limites de string/array/objeto)
Estruturadas (saída JSON + structuredContent)
Dados brutos acessíveis sob demanda por meio de recursos como:
- georanker://serp/{id}
- georanker://keywords/{id}
- georanker://regions

Multiplataforma

Execute o mesmo servidor para:

Claude Desktop (stdio)
Cursor (HTTP Streamable)
OpenAI Remote MCP (HTTP Streamable ou HTTP+SSE)
LangChain / qualquer aplicativo Node (via cliente MCP OU endpoints OpenAPI)

Instalação

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

Configuração

Variáveis de ambiente

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

Flags de CLI (substituem variáveis de ambiente)

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

Execução

1) Modo stdio (Claude Desktop / local)

GEORANKER_API_KEY=... georanker-mcp

2) Modo HTTP (recomendado para Cursor / hospedado)

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 (e POST /messages)
OpenAPI: http://127.0.0.1:3333/openapi.json
Server Card: http://127.0.0.1:3333/.well-known/mcp/server-card.json

Alvos de Integração

Claude Desktop (stdio)

Adicione à configuração do seu Claude Desktop:

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

Cursor (HTTP Streamable)

Execute o servidor em modo HTTP (--transport http)
No Cursor, adicione um servidor MCP com URL:
- http://127.0.0.1:3333/mcp (local)
- ou sua URL HTTPS implantada para uso hospedado

OpenAI (Remote MCP)

Implante o servidor HTTP em uma URL HTTPS pública e configure uma ferramenta MCP remota apontando para:

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

LangChain / aplicativos Node

Opção A: use um cliente MCP para conectar ao endpoint MCP. Opção B: chame os endpoints OpenAPI em /api/v1/*.

Nomes das Ferramentas (novos)

Os nomes recomendados das ferramentas são namespaced:

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

Nomes legados de ferramentas

Defina GR_ENABLE_LEGACY_TOOL_NAMES=true ou execute com --legacy para também expor as ferramentas antigas em snake_case.

Formato de Saída

Todas as ferramentas retornam JSON compacto no formato:

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

Se uma ferramenta falhar, ela retorna ok:false e o resultado da ferramenta MCP incluirá isError:true.

Publicação

npm

Build:
```
npm run build
```
Login:
```
npm login
```
Publicar:
```
npm publish --access public
```

Registro MCP Smithery

Publicação por URL (recomendado para servidores hospedados):

Certifique-se de que o HTTP Streamable esteja disponível em /mcp
Garanta que o server card exista em /.well-known/mcp/server-card.json

Em seguida, publique pela interface do Smithery ou via CLI:

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

Publicação local (stdio):

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

Licença

MIT