（6156期）brave-api-search – 官方 API 驱动的实时智能搜索

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