核心用法
Brave API Search 提供两个互补工具::brave_search 用于传统网页搜索,返回带标题、URL、描述的排名结果,支持 AI 摘要;brave_answers 则提供带内联引用的 AI 合成答案,适合深度研究。用户需配置 BRAVE_SEARCH_API_KEY 和 BRAVE_ANSWERS_API_KEY 环境变量,通过标准 HTTPS 调用官方 API。
显著优点
合规性与可靠性:区别于爬虫方案,使用官方 API 获得结构化 JSON 响应,自带速率限制头和标准错误处理,完全遵守服务条款。双工具设计兼顾快速检索与深度研究——brave_search 的 freshness 参数支持按时间过滤(24小时至1年),brave_answers 的 enable_research 可触发多轮搜索合成复杂答案。
零依赖架构:仅使用 Node.js 内置模块,无第三方包引入供应链风险。输入验证严格(count 限制 1-20,freshness 白名单校验),错误信息定向输出至 stderr 避免敏感泄露。
潜在局限
成本门槛:免费版仅 2000 次/月、1 QPS,高频场景需付费(搜索 $5/千次,答案 $4/千次)。功能边界:不支持本地文件索引或私有知识库检索,纯依赖 Brave 的公开网络覆盖。地理限制:默认 US 区域,多语言/本地化搜索需显式配置 country 参数。
适合人群
开发者查阅最新技术文档、研究者追踪时事动态、内容创作者核实信源、产品经理竞品调研——任何需要时效性外部信息且重视引用可追溯性的场景。不适合已有充足上下文或纯内部数据的问答。
使用风险
网络依赖导致 Brave API 故障时服务中断;搜索查询明文传输至第三方存在基础隐私暴露;高频调用易触达速率上限;无内置缓存机制可能产生冗余 API 开销。建议生产环境配置超时重试与响应缓存层。