🚨 Предупреждение 🚨

Это просто предупреждение. Мы не видели никаких банов от использования GSearch.

Не связано с Google. Использует тот же публичный OAuth-клиент и API, что и открытый Gemini CLI.

Google недавно забанил некоторых пользователей OpenClaw. Сценарии использования OpenClaw для oauth-провайдеров выглядят для меня злоупотреблением. GSearch не подходит под эту схему. Риск всё же существует.

Запросы несут User-Agent, ideType и форму запроса Gemini CLI, так что, вероятно, они неотличимы от официального клиента на проводе (если ты гуглер и читаешь это: мы хорошие люди, пожалуйста, не охотись на нас 🙏). Если это тебя беспокоит, используй одноразовый аккаунт Google.

GSearch - Free Google Search MCP

Дайте Claude Code, Codex CLI, Cursor и другим AI-инструментам поиск в реальном времени на основе Google Search grounding. Один бинарник, ноль зависимостей во время выполнения. Бесплатно с любым аккаунтом Google.

Установка

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

Или соберите из исходников:

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

Установщик загружает бинарник, автоматически настраивает Claude Code, Codex и Cursor (если они доступны).

Related MCP server: SERPJET MCP Server

Как это работает

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

Когда AI-инструмент вызывает google_search, GSearch возвращает обоснованный ответ с встроенными цитатами:

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://...)

Цены и лимиты

GSearch использует тот же API поиска Google Search, что и Gemini CLI. Бесплатно с любым аккаунтом Google. Без API-ключа, без кредитной карты, без настройки биллинга.

Лимиты запросов щедрые для обычного использования. Сервер автоматически повторяет попытки с динамической задержкой при быстрых всплесках.

Аутентификация

Три варианта:

1. Gemini CLI (если установлен) — GSearch повторно использует существующие учётные данные из ~/.gemini/oauth_creds.json

2. Интерактивный OAuth — ./gsearch-installer открывает браузер для входа в Google

3. API-ключ — вставьте ключ Gemini API с aistudio.google.com в установщик или задайте переменную окружения GEMINI_API_KEY / GSEARCH_API_KEY

Режимы OAuth автоматически создают новые аккаунты через Google Code Assist API (при первом использовании может потребоваться SMS-подтверждение). Режим API-ключа полностью пропускает OAuth и обращается напрямую к Gemini API.

Конфигурация

Установщик настраивает всё автоматически. Для ручной настройки добавьте в конфиг вашего MCP-клиента:

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

Работает с Claude Code (~/.claude.json), Cursor (~/.cursor/mcp.json) и любым инструментом, совместимым с MCP.

Для Codex CLI (~/.codex/config.toml):

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

Задайте переменную окружения GSEARCH_PROJECT только если автоматическое определение не сработало.

Лицензия

MIT