用途：为 Claude Desktop、Cursor、Windsurf 等 MCP 客户端提供实时网页搜索，借助 Google AI Mode（Gemini）返回基于实时结果的综合答案，无需 API 密钥。
主要能力：提供两个 MCP 工具——web_search(query) 执行联网搜索并返回综合答案；ask(prompt) 用于一般问题，由 AI Mode 自行判断是否需要搜索。此外可作为 OpenAI 兼容 API 服务器供非 MCP 客户端使用。
安装与用法：pip install -e . 安装；如需抗验证码可 pip install -e '.[undetected]'。要求 Python 3.10+ 及 Chrome、Edge 或 Chromium 浏览器。Claude Code 可用 claude mcp add gemini-search -- gemini-search-mcp；Claude Desktop、Cursor、Windsurf 需在对应 MCP 配置中设置 command 为 gemini-search-mcp。作为 API 运行时执行 gemini-search --port 8080，再以 base_url 为 http://localhost:8080/v1、api_key 任意值调用。
配置：支持 CDP_URL、BROWSER_CHANNEL、HEADLESS、GEMINI_SEARCH_USER_DATA_DIR、GEMINI_SEARCH_CDP_PORT、GEMINI_SEARCH_BROWSER_BACKEND、GEMINI_SEARCH_PROXY_SERVER、GEMINI_SEARCH_CHROMEDRIVER 等环境变量，可连接已有 Chrome、使用持久化配置或代理。
适用场景：需要实时信息、无 API 密钥或配额限制的搜索增强型智能体。
限制：依赖真实浏览器与 Google 页面结构，可能遇到验证码、限流、启动失败或 DOM 变更导致解析异常；首次请求较慢，平均约 1.5 秒。资料未提供收费与价格信息。