核心用法
Brave API Search 提供三类工具覆盖搜索全流程：
1. `brave_search` — 标准网页搜索，返回带标题、URL、描述的排序结果，支持 site: 运算符、精确短语匹配、时间过滤（24小时/7天/31天/1年）及 AI 摘要生成。
2. `brave_suggest` — 实时查询自动补全，模拟搜索引擎下拉建议，可选富媒体元数据（标题、描述、图片）。建议配合 150-300ms 防抖使用。
3. `brave_answers` — AI 驱动的答案合成，基于实时搜索结果生成带内联引证的回答，支持「深度研究模式」自动执行多轮搜索。
显著优点
- 官方 API 保障：结构化 JSON 响应、合规 TOS、明确的 Rate Limit headers
- AI 原生集成：摘要生成与引文答案均基于实时搜索，非幻觉生成
- 搜索语法完整：支持站点限定、排除词、精确短语等高级运算符
- 场景覆盖广：从即时事实查询到多源研究任务均可胜任
潜在局限
- 双密钥配置：需分别申请
BRAVE_SEARCH_API_KEY与BRAVE_ANSWERS_API_KEY，无法单密钥降级使用 - 计费复杂度高：搜索与答案分别计费，富媒体建议需付费套餐，免费额度不稳定（官方提示勿假设固定免费请求数）
- 地理限制：部分功能（如建议的 rich 模式）受付费计划约束
- 无本地缓存：每次调用均为实时 API 请求，高频场景需自行实现缓存层
适合人群
- 需要为 AI Agent 添加实时信息能力的开发者
- 构建搜索增强型 RAG 系统的技术团队
- 新闻追踪、竞品监控、技术文档检索等时效性场景
常规风险
- 成本失控：深度研究模式（
enable_research）可能触发多轮搜索，建议在受控环境测试后再启用 - API 额度耗尽：无内置限流或配额检查，需自行监控仪表盘
- 引证质量依赖：AI 答案的准确性受搜索结果质量影响，关键决策需人工复核来源
- 密钥泄露：
.env配置虽推荐，但无运行时密钥验证，误提交代码风险存在