Brave Api Search

核心功能

Brave API Search 提供三重搜索能力：实时网页检索、智能自动补全、AI驱动答案生成。

`brave_search` 返回结构化搜索结果，支持时间过滤（24小时/7天/31天/1年）、AI摘要生成，以及高级搜索语法（site:限定、精确匹配、排除词）。

`brave_suggest` 提供实时查询补全，付费计划可解锁富媒体元数据（标题、描述、图片）。

`brave_answers` 是核心差异化功能，基于实时搜索生成带内联引用的AI答案，支持多轮深度研究模式（enable_research），适合复杂调研场景。

显著优点

• 官方API合规：结构化JSON响应，非爬虫，有明确的服务条款保障
• 引用溯源：AI答案附带可验证的来源链接，降低幻觉风险
• 响应速度：无需本地模型推理，云端直接返回答案
• 灵活定价：积分制计费，搜索与答案消耗不同，适合轻量到中等规模使用

潜在局限

• 双密钥配置：需分别申请 BRAVE_SEARCH_API_KEY 和 BRAVE_ANSWERS_API_KEY，配置略繁琐
• 成本不确定性：官方定价动态调整，无固定免费额度承诺，生产环境需实时监控用量
• 付费功能壁垒：富媒体建议、深度研究模式需升级计划
• 地理限制：答案质量可能因 country 参数设置产生偏差

适用人群

• 需要实时信息的开发者、研究员、内容创作者
• 构建搜索界面的产品团队（自动补全场景）
• 追求可验证AI答案的用户（带引用场景）
• 不愿承担本地大模型部署成本的轻量级用户

常规风险

• API密钥泄露：.env 文件误提交或硬编码导致额度盗刷
• 意外超支：未设置用量告警时，自动补全高频调用或研究模式可能快速消耗积分
• 答案时效性：即使标注了引用，原始网页内容可能已变更
• 合规边界：虽为官方API，仍需遵守Brave服务条款，禁止大规模数据抓取

核心功能

Brave API Search 是官方 Brave Search API 的封装工具，提供三大核心能力：

• `brave_search`：实时网页搜索，返回标题、URL、描述及可选 AI 摘要，支持时间筛选（24小时/7天/31天/1年）和搜索运算符
• `brave_suggest`：查询自动补全，支持富媒体元数据（标题、描述、图片），适合搜索框实时提示
• `brave_answers`：AI 驱动的生成式答案，带内联引用，支持深度研究模式（多轮搜索聚合）

显著优点

架构简洁可靠：纯 Node.js 内置模块实现，零外部 npm 依赖，彻底规避供应链攻击风险。代码仅 6 个文件、600+ 行，结构清晰易审计。

安全设计规范：API Key 严格通过环境变量读取（BRAVE_SEARCH_API_KEY / BRAVE_ANSWERS_API_KEY），无硬编码密钥；仅访问 Brave 官方域名（api.search.brave.com），全链路 HTTPS/TLS 加密。

功能与文档一致：实际代码行为与 SKILL.md 声明完全匹配，无隐藏功能或越权行为，通过静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报六项检测。

潜在局限

商业成本门槛：非完全免费工具，需订阅 Brave Search API 套餐；Rich Suggestions 需付费计划，AI Answers 可能产生 token 费用。生产环境需监控用量避免超额。

地域与配额限制：搜索结果受 country 参数影响，默认 US；QPS 限制因套餐层级而异，高并发场景需评估容量。

功能边界明确：不提供浏览器自动化、页面渲染或 JavaScript 执行能力，无法处理需登录或动态加载的网页内容。

适用人群

• 开发者构建智能搜索、研究助手、知识问答应用
• 需要可信来源引用的学术/商业研究场景
• 追求供应链安全、拒绝冗余依赖的极简技术栈团队
• 需替代传统爬虫、规避反爬与法律风险的合规敏感场景

常规风险

• API 可用性依赖：服务连续性受 Brave 平台影响，需关注其服务状态
• 输入校验建议：当前仅对 count 参数做范围限制，可考虑增强 query 长度与特殊字符校验
• 密钥轮换管理：建议定期轮换 API Key，避免长期暴露风险