网页搜索
适用于 OpenCode V2；核验日期：2026-11-12。
需要最新发布、文档或公开资料时，可让 OpenCode 搜索并给出来源。首次搜索会要求许可并选择搜索提供商，选择会用于后续会话。搜索不是模型提供商的同义词。
# 连接与选择#
支持 Exa、Firecrawl、Parallel、Tavily 和 TinyFish。环境变量分别是 EXA_API_KEY、FIRECRAWL_API_KEY、PARALLEL_API_KEY、TAVILY_API_KEY、TINYFISH_API_KEY，TinyFish 密钥可选。也可用 /connect 连接。
json1{ 2 "$schema": "https://opencode.ai/config.json", 3 "websearch": { "provider": "tavily" } 4}
需要先配置相应账户或环境。使用 "random" 自动选择可用提供商，一个会话会继续使用所选提供商，直到遇到限流。
# 限流与回退#
自动选择模式遇到 HTTP 429 会尝试其他可用提供商。冷却遵循 Retry-After，缺少有效值时为 60 秒。全部处于冷却时立即失败，同工作区的会话共享冷却；移动会话或重启服务器会清除记忆的提供商选择。
# 权限与数据#
json1{ 2 "permissions": [ 3 { "action": "websearch", "resource": "*", "effect": "ask" } 4 ] 5}
资源是查询文字，不是搜索结果网址。查询会发送给搜索服务，不应包含秘密、未公开客户数据或凭据。组织也可用 websearch.use 策略限制供应商。
要移除搜索工具：
json{ "websearch": false }
搜索发现信息后仍应打开原始来源核实，尤其注意发布日期、版本和付费或地区限制。webfetch 是读取指定 URL，与搜索权限不同。