🚨 면책 고지 🚨

참고용 공지입니다. GSearch 사용으로 인한 밴 사례는 아직 확인되지 않았습니다.

Google과 제휴 관계가 아닙니다. 오픈소스 Gemini CLI와 동일한 공개 OAuth 클라이언트 및 API를 사용합니다.

Google이 최근 일부 OpenClaw 사용자를 밴한 사례가 있습니다. OAuth 제공업체에 대한 OpenClaw 사용 패턴은 남용으로 보입니다. GSearch는 해당 패턴에 해당하지 않지만, 위험은 여전히 존재합니다.

요청에는 Gemini CLI의 User-Agent, ideType, 요청 형식이 포함되어 있어 유선상으로 공식 클라이언트와 구분이 거의 불가능할 것입니다 (혹시 이 글을 읽는 구글러가 있다면: 저희는 착한 사람들이니 쫓아다니지 말아주세요 🙏). 이 점이 불편하다면 임시 Google 계정을 사용하세요.

GSearch - 무료 Google 검색 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: MCP Gemini Google Search

작동 방식

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는 Gemini CLI와 동일한 Google Search grounding API를 사용합니다. 모든 Google 계정으로 무료 사용 가능. API 키, 신용카드, 결제 설정이 필요 없습니다.

일반적인 사용량에 대해 속도 제한은 넉넉합니다. 서버는 빠른 연속 요청 시 동적 백오프로 자동 재시도합니다.

인증

세 가지 옵션:

1. Gemini CLI (설치된 경우) — GSearch가 ~/.gemini/oauth_creds.json의 기존 자격 증명을 재사용합니다

2. 대화형 OAuth — ./gsearch-installer가 Google 로그인을 위해 브라우저를 엽니다

3. API 키 — aistudio.google.com에서 Gemini API 키를 복사해 설치 프로그램에 붙여넣거나, 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