核心用法
Brave API Search 整合三个互补工具:brave_search 提供传统网页检索,支持时间筛选、AI 摘要与分页;brave_suggest 实现查询自动补全,可选富媒体元数据;brave_answers 则输出带内联引用的 AI 综合答案,并支持深度研究模式。所有工具均通过官方 api.search.brave.com 端点通信,需配置 BRAVE_SEARCH_API_KEY 与 BRAVE_ANSWERS_API_KEY(支持级联回退)。
显著优点
- 实时性与权威性:直接对接 Brave 搜索引擎,结果新鲜且覆盖新闻、技术文档等多元内容
- 引用可验证:
brave_answers的流式输出强制附带来源引用,降低幻觉风险 - 工程优化到位:内置指数退避重试、60 秒内存缓存、并行摘要获取,提升稳定性与性能
- 隐私友好:Brave 以隐私为核心,API 不追踪用户搜索历史
潜在局限
- 成本波动:采用信用积分计费,免费额度不稳定且无固定承诺;深度研究模式与 token 消耗可能产生额外费用
- 功能依赖商业计划:富媒体建议 (
rich=true) 需付费 Autosuggest 方案 - 区域限制:部分国家/地区的内容可用性受 Brave 搜索索引覆盖度影响
适合人群
需快速获取时效信息的技术从业者、研究人员、内容创作者;构建搜索增强型 AI 应用的开发者;对答案溯源有硬性要求的场景(如学术辅助、新闻核查)。
常规风险
API 密钥泄露可能导致配额滥用与账单损失,务必使用 .env 文件管理并排除在版本控制外。流式模式下的 token 费用需监控,避免意外高额消耗。