Gemini CLI 有两个 Web 工具：google_web_search 通过 Google 搜索获取最新资讯并附带来源引用；web_fetch 可一次处理最多 20 个 URL，提取和综合网页内容。两者均通过 Gemini API 处理，web_fetch 在 Plan Mode 下始终需要用户确认，API 失败时会直接从本机发起请求作为备用。

Web 工具参考

Gemini CLI 内置两个联网工具，让 AI 代理可以获取实时网络信息。

`google_web_search`（网页搜索）

使用 Google 搜索检索最新信息、新闻和文档。

参数：

参数	类型	必填	说明
`query`	string	是	搜索查询字符串

技术行为：

Grounding（接地气）：基于搜索结果生成综合摘要，而非直接返回原始网页内容
引用来源：结果包含原始页面的 URI 和标题，确保可追溯性
由 Gemini API 处理：搜索结果经 Gemini 模型综合后返回给代理

典型场景：

最新版本的 Next.js 是什么？有什么重要变化？
帮我找 VSCode 1.90 版本的发布说明
React 19 的并发特性有哪些最新进展？

`web_fetch`（URL 内容抓取）

当你在 Prompt 中提供具体 URL 时，代理调用此工具获取并处理页面内容。

参数：

参数	类型	必填	说明
`prompt`	string	是	包含最多 20 个有效 URL（以 `http://` 或 `https://` 开头）及处理指令的请求

技术行为：

确认对话框：触发时会显示确认弹窗，列出要访问的 URL
Plan Mode 限制：在 Plan Mode 下，web_fetch 始终需要用户显式确认（即使开启了自动批准），因为访问外部或内网地址存在安全隐患
处理方式：使用 Gemini API 的 urlContext 功能获取并分析内容
回退机制：API 访问失败时，工具会从本机直接发起请求作为备用
综合输出：返回带来源标注的综合性回答

典型场景：

总结一下这篇文章的要点：https://example.com/blog/post
比较这两个文档的差异：https://v1.docs.com https://v2.docs.com
从这个页面提取所有代码示例：https://library.example.com/api

两者对比

维度	`google_web_search`	`web_fetch`
适用场景	不知道具体页面，需要搜索	已有确定 URL，需要提取内容
来源	Google 搜索结果	指定 URL
URL 数量	—	最多 20 个
Plan Mode	通常无需额外确认	始终需要用户确认
回退	—	API 失败时从本机发起请求

决策建议：

需要了解最新事件、查询文档版本号 → 用 google_web_search
有具体网页链接需要提取/比较/总结内容 → 用 web_fetch
两者可以组合：先搜索找到相关页面，再 fetch 获取详细内容

进一步阅读

实用操作示例：Web 搜索与抓取教程
所有命令参数：CLI 命令速查

常见问题

Q: web_fetch 能抓取需要登录的页面吗？

A: 默认情况下不能，因为代理没有登录凭证。可以通过配置 Browser Agent（浏览器代理）来自动化登录操作，或手动复制页面内容粘贴给代理。

Q: 搜索结果会实时更新吗？

A: 是的。google_web_search 使用 Google 搜索，结果反映当前网络内容，不受模型知识截止日期限制——这是相比直接问模型的核心优势。

Q: web_fetch 的 20 个 URL 限制是硬限制吗？

A: 是的，每次调用最多处理 20 个 URL。如果需要处理更多页面，可以分多次调用。

Web 工具参考 ​

google_web_search（网页搜索） ​

web_fetch（URL 内容抓取） ​

两者对比 ​