实时搜索 + AI 答案，带引用溯源

基于 Brave Search API 的实时搜索与 AI 答案引擎，支持网页搜索、智能补全、拼写纠错及带引用溯源的 AI 问答，v4.2.0 新增实体提取功能。

基本信息

• 技能名称?Brave Api Search
• 中文名称?实时搜索 + AI 答案，带引用溯源
• 作者?broedkrummen
• 分类?专业技能
• 版本?4.2.0
• 标签?search-engine, api, web-search, ai-answers, real-time-data, citations, brave, knowledge-retrieval, rag

使用方法

使用说明
核心功能
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 索引更新频率制约