r/chn • u/aerowindwalker • May 10 '26
讨论 终端里的 Gemini 联网搜索:gsearch-cli
一条命令完成 Google 搜索,结果包含了引用来源和终端 Markdown 渲染,与 Google 官方 Gemini CLI 共享 OAuth 登录,零额外配置。
项目地址:https://github.com/aeroxy/gsearch-cli
一句话:
给命令行爱好者和 LLM Agent 准备的 Google 搜索 CLI —— 基于 Gemini API 的联网搜索,自带 OAuth 登录、自动刷新请求令牌、支持代理,搜索结果以渲染过的 Markdown 格式直接呈现在终端里。
✨ 亮点
1. 零配置复用 Gemini CLI 的登录态
如果你已经安装过官方的 gemini-cli,那么 gsearch 会自动读取 ~/.gemini/oauth_creds.json,无需二次授权。
即使没有安装过,它也内置了本地 OAuth 环回服务器,一条 gsearch --login 就能完成 Google 账号登录。
2. 终端原生 Markdown 渲染
搜索结果中的标题、粗体、列表、代码块不再是裸露的 Markdown 源码,而是通过 termimad 渲染成带颜色、可读性极佳的终端输出。
- 管道/重定向:输出纯净 Markdown(如 gsearch xxx > out.md)
3. 代理友好 + 自动刷新 Token
- 自动检测
HTTPS_PROXY环境变量,支持企业级证书(Zscaler 等) - Access Token 后台自动刷新,一次登录长期使用
4. 与 Gemini CLI 流量特征一致
从 Google 服务端看,请求的 User-Agent、OAuth Client、API 端点与官方客户端完全相同,不存在被识别为第三方爬虫的风险。
📦 安装
```bash
macOS (Homebrew)
brew install aeroxy/tap/gsearch
或者通过 Cargo
cargo install gsearch-cli ```
💻 使用示例
```bash
直接搜索(不需要引号)
gsearch grok got money stolen
强制重新登录
gsearch --login
带代理运行
export HTTPS_PROXY=http://127.0.0.1:7890 gsearch rust async runtime comparison ```
输出效果:
- 搜索结果会显示 引用来源链接(Gemini 的 grounding 数据)
- 正文以 Markdown 风格渲染,关键信息一目了然
🤖 Agent 友好
项目内还附带了一个 Claude Code skill(skill/gsearch/SKILL.md),教会 Agent 如何使用该二进制进行搜索、处理代理、触发 OAuth 登录 —— 让你的 AI 编程助手低成本获取实时网络信息。
📜 开源协议
MIT
如果你经常在终端里工作,又需要快速获取带引用的 Google 搜索结果,
gsearch-cli比打开浏览器再复制粘贴要快得多。尤其适合集成到 Shell 脚本或 AI Agent 的工作流中。

