🚨 免責事項 🚨

これは事前のお知らせです。GSearch の使用によるアカウント停止は確認されていません。

Google とは提携関係にありません。オープンソースの Gemini CLI と同じ公開 OAuth クライアントと API を使用しています。

Google は最近、一部の OpenClaw ユーザーをアカウント停止にしました。OpenClaw の OAuth プロバイダーの利用方法は、私には悪用に見えます。GSearch はそのパターンには当てはまりません。ただし、リスクは依然として存在します。

リクエストには Gemini CLI の User-Agent、ideType、リクエスト形式が含まれるため、通信上は公式クライアントと区別がつかない可能性が高いです (もしこれを読んでいる Google の方がいらっしゃいましたら: 私たちは善良な人々です、どうか追跡しないでください 🙏)。それが気になる場合は、使い捨ての Google アカウントを使用してください。

GSearch - 無料の Google 検索 MCP

Claude Code、Codex CLI、Cursor、その他の AI ツールに、Google 検索グラウンディングを利用したリアルタイムのウェブ検索を提供します。単一バイナリ、ランタイム依存関係ゼロ。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 は Gemini CLI と同じ Google 検索グラウンディング API を使用しています。Google アカウントがあれば無料です。 API キー不要、クレジットカード不要、請求設定も不要です。

レート制限は通常の使用には十分な余裕があります。サーバーは急激なバースト時に動的バックオフで自動的に再試行します。

認証

3 つのオプションがあります:

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