⚠️ Aviso ⚠️

Esto es solo un aviso. No hemos visto ningún bloqueo por el uso de GSearch.

No está afiliado a Google. Utiliza el mismo cliente OAuth público y la misma API que el CLI de Gemini de código abierto.

Google recientemente bloqueó a algunos usuarios de OpenClaw. Los casos de uso de OpenClaw para proveedores de OAuth me parecen abusivos. GSearch no encaja en ese patrón. El riesgo sigue existiendo.

Las solicitudes llevan el User-Agent, ideType y la forma de solicitud del CLI de Gemini, por lo que probablemente sean indistinguibles del cliente oficial en la red (si un googler está leyendo esto: somos buena gente, por favor no nos bloqueen 🙏). Si eso te preocupa, usa una cuenta de Google desechable.

GSearch - Búsqueda gratuita de Google MCP

Dale a Claude Code, Codex CLI, Cursor y otras herramientas de IA búsqueda web en tiempo real impulsada por el grounding de Google Search. Un solo binario, cero dependencias en tiempo de ejecución. Gratis con cualquier cuenta de Google.

Instalación

curl -fsSL https://raw.githubusercontent.com/daanielcruz/gsearch-mcp/main/install.sh | bash

O compilar desde el código fuente:

git clone https://github.com/daanielcruz/gsearch-mcp && cd gsearch-mcp
make build && ./gsearch-installer

El instalador descarga el binario y configura Claude Code, Codex y Cursor automáticamente (si están disponibles).

Related MCP server: MCP Gemini Google Search

Cómo funciona

Claude Code / Codex CLI / Cursor / Others...
        | MCP (stdio)
   gsearch-server (Go binary)
        | OAuth2
   Google Code Assist API
        | googleSearch grounding
   Answer with [1][2][3] source links

Cuando una herramienta de IA llama a google_search, GSearch devuelve una respuesta fundamentada con citas en línea:

The current time in Sao Paulo is 08:13 AM.[1][2]
Sao Paulo observes Brasilia Time (BRT), UTC-3.[3]

Sources:
[1] Time in Sao Paulo (https://...)
[2] World Clock (https://...)
[3] Time Zone Info (https://...)

Precios y límites

GSearch utiliza la misma API de grounding de Google Search que el CLI de Gemini. Gratis con cualquier cuenta de Google. Sin clave de API, sin tarjeta de crédito, sin configuración de facturación.

Los límites de uso son generosos para un uso normal. El servidor reintenta automáticamente con retroceso dinámico ante ráfagas rápidas.

Autenticación

Tres opciones:

1. CLI de Gemini (si está instalado) — GSearch reutiliza las credenciales existentes de ~/.gemini/oauth_creds.json

2. OAuth interactivo — ./gsearch-installer abre tu navegador para iniciar sesión con Google

3. Clave de API — pega una clave de API de Gemini desde aistudio.google.com en el instalador, o establece la variable de entorno GEMINI_API_KEY / GSEARCH_API_KEY

Los modos OAuth aprovisionan automáticamente cuentas nuevas a través de la API de Google Code Assist (puede requerirse verificación por SMS en el primer uso). El modo de clave de API omite OAuth por completo y accede directamente a la API de Gemini.

Configuración

El instalador configura todo automáticamente. Para configuración manual, añade a tu archivo de configuración del cliente MCP:

{
  "mcpServers": {
    "gsearch": {
      "command": "npx",
      "args": ["-y", "@daanielcruz/gsearch-mcp"]
    }
  }
}

Funciona con Claude Code (~/.claude.json), Cursor (~/.cursor/mcp.json) y cualquier herramienta compatible con MCP.

Para Codex CLI (~/.codex/config.toml):

[mcp_servers.gsearch]
command = 'npx'
args = ['-y', '@daanielcruz/gsearch-mcp']

Establece la variable de entorno GSEARCH_PROJECT solo si falla la detección automática.

Licencia

MIT