核心功能
brave-api-search 是一套完整的搜索技能套件，基于 Brave 官方 Search API 构建，提供四大核心能力：
| 工具 | 用途 |
|------|------|
| `brave_search` | 实时网页搜索，返回标题、URL、描述，可选 AI 摘要 |
| `brave_suggest` | 查询自动补全，支持富元数据（标题、图片、实体） |
| `brave_spellcheck` | 拼写纠错与 "Did you mean?" 建议 |
| `brave_answers` | AI 驱动的实时答案，带内联引用与实体提取 |
v4.2.0 重大更新
- 实体提取：通过
--enable-entities自动识别并提取答案中的关键实体，附带引用计数 - 流式优化：实体与引用实时解析、去重，支持渐进式输出
- 非流式模式增强：即使禁用流式，也能完整提取引用与实体
显著优点
- 实时性与权威性：直接调用 Brave 搜索索引，信息新鲜度优于训练数据截止的模型
- 引用溯源：
brave_answers自动标注信息来源，支持学术研究、事实核查场景 - 多 API 密钥降级策略：
brave_suggest和brave_spellcheck支持多级密钥回退，降低配置门槛 - 零依赖轻量：纯 Node.js 18+ 实现，无外部 npm 依赖
- 智能缓存：
brave_suggest内置 60 秒 TTL 内存缓存，减少重复调用
潜在局限
- 成本不可预测：采用信用积分制，无固定免费额度，需实时监控仪表板
- 富建议需付费：
--rich模式依赖独立的 Autosuggest 付费计划 - 流式强制依赖：引用、实体、研究模式必须开启流式（
--stream true），否则功能降级 - 地理限制：部分功能需指定国家代码，全球化场景需额外配置
适合人群
- 需要实时信息检索的开发者、研究人员、新闻工作者
- 构建搜索增强型 AI 应用的产品团队（RAG 场景）
- 追求答案可溯源的企业知识库、客服系统架构师
常规风险
- API 密钥泄露：需严格管理
.env文件，避免提交至版本控制 - 速率限制：429 错误需配合指数退避重试，高并发场景需评估 QPS 限额
- 成本超支：积分消耗与 token 用量挂钩，建议设置用量告警
- 信息时效幻觉：虽优于静态模型，但仍受 Brave 索引更新频率制约