{
  "markdown": "<div align=\"center\">\n\n>\n> ### 🚨 Disclaimer 🚨\n>\n> **This is just a heads-up. We haven't seen any bans from GSearch use.**\n>\n> Not affiliated with Google. Uses the same public OAuth client and API as the [open-source Gemini CLI](https://github.com/google-gemini/gemini-cli).\n>\n> \n> Google recently banned some OpenClaw users. OpenClaw use cases for oauth providers look abusive to me. GSearch doesn't fit that pattern. Risk still exists.\n>\n> Requests carry Gemini CLI's User-Agent, ideType, and request shape, so they're probably indistinguishable from the official client on the wire _(if u a googler reading this: we good ppl, plz don't hunt us 🙏)_. If that bothers you, use a throwaway Google account.\n\n---\n\n<img src=\"news.png\" alt=\"GSearch - Free Google Search MCP\" style=\"height: 300px;\" />\n\n# GSearch - Free Google Search MCP\n\n[![Go](https://img.shields.io/badge/Go-1.26+-00ADD8?logo=go&logoColor=white)](https://go.dev)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-8A2BE2)](https://modelcontextprotocol.io)\n\nGive Claude Code, Codex CLI, Cursor, and other AI tools real-time web search powered by Google Search grounding. Single binary, zero runtime dependencies. **Free with any Google account.**\n\n</div>\n\n\n\n## Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/daanielcruz/gsearch-mcp/main/install.sh | bash\n```\n\nOr build from source:\n\n```bash\ngit clone https://github.com/daanielcruz/gsearch-mcp && cd gsearch-mcp\nmake build && ./gsearch-installer\n```\n\nThe installer downloads the binary, configures Claude Code, Codex and Cursor automatically (if available).\n\n## How It Works\n\n```\nClaude Code / Codex CLI / Cursor / Others...\n        | MCP (stdio)\n   gsearch-server (Go binary)\n        | OAuth2\n   Google Code Assist API\n        | googleSearch grounding\n   Answer with [1][2][3] source links\n```\n\nWhen an AI tool calls `google_search`, GSearch returns a grounded answer with inline citations:\n\n```\nThe current time in Sao Paulo is 08:13 AM.[1][2]\nSao Paulo observes Brasilia Time (BRT), UTC-3.[3]\n\nSources:\n[1] Time in Sao Paulo (https://...)\n[2] World Clock (https://...)\n[3] Time Zone Info (https://...)\n```\n\n## Pricing & Limits\n\nGSearch uses the same Google Search grounding API as [Gemini CLI](https://github.com/google-gemini/gemini-cli). **Free with any Google account.** No API key, no credit card, no billing setup.\n\nRate limits are generous for normal usage. The server retries automatically with dynamic backoff on rapid bursts.\n\n## Authentication\n\nThree options:\n\n1. **Gemini CLI** (if installed) — GSearch reuses existing credentials from `~/.gemini/oauth_creds.json`\n2. **Interactive OAuth** — `./gsearch-installer` opens your browser for Google sign-in\n3. **API key** — paste a Gemini API key from [aistudio.google.com](https://aistudio.google.com/apikey) into the installer, or set `GEMINI_API_KEY` / `GSEARCH_API_KEY` env var\n\nOAuth modes auto-provision new accounts via the Google Code Assist API (SMS verification may be required on first use). API key mode skips OAuth entirely and hits the Gemini API directly.\n\n## Configuration\n\nThe installer configures everything automatically. For manual setup, add to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"gsearch\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@daanielcruz/gsearch-mcp\"]\n    }\n  }\n}\n```\n\nWorks with Claude Code (`~/.claude.json`), Cursor (`~/.cursor/mcp.json`), and any MCP-compatible tool.\n\nFor Codex CLI (`~/.codex/config.toml`):\n\n```toml\n[mcp_servers.gsearch]\ncommand = 'npx'\nargs = ['-y', '@daanielcruz/gsearch-mcp']\n```\n\nSet `GSEARCH_PROJECT` env var only if auto-detection fails.\n\n## License\n\nMIT\n",
  "bytes": 3710,
  "sha": "f069f9f0e5f3319e88c1632f9a4740457b530d7f9b461784677dabcf7939ed63",
  "repo_slug": "daanielcruz/gsearch-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_daanielcruz_gsearch_mcp_gsearch_207b8a0d/readme"
}