核心用法
Brave Web Search 是一个基于 Brave Search API 的网络搜索技能，提供两种互补的查询模式：
- `brave-search`：返回带排名的网页结果列表，包含标题、URL 和摘要片段，适合需要浏览多来源、获取原始出处的场景
- `brave-answer`：直接返回 AI 生成的精简答案摘要，适合快速获取事实性问题的结论
使用时需通过参数数组方式调用（如 execFile 风格），禁止将用户输入拼接进 shell 命令字符串。支持时间过滤参数 --freshness（pd=过去一天/pw=过去一周/pm=过去一个月），便于追踪时效性信息。若 AI 答案返回空，系统会自动回退到常规搜索结果。
显著优点
1. 零依赖轻量设计：纯 Node.js 原生实现，无需额外安装依赖包，部署简单
2. 双模式灵活切换：搜索结果与 AI 摘要按需选用，兼顾深度调研与效率优先
3. 隐私友好来源：Brave Search 以隐私保护著称，不追踪用户搜索行为
4. 安全执行模型：强制参数数组调用，从架构层面杜绝 shell 注入风险
潜在局限
- API 密钥依赖：需配置
BRAVE_SEARCH_API_KEY和BRAVE_ANSWERS_API_KEY，免费额度有限 - 答案质量波动：
brave-answer的 AI 摘要可能遗漏细节或产生幻觉，复杂议题建议交叉验证 - 中文支持一般：Brave Search 对中文内容的索引覆盖与排序优化弱于百度/Google
- 无高级筛选：缺少站点限定、文件类型过滤等高级搜索语法
适合人群
- 需要快速获取实时信息、新闻动态的知识工作者
- 偏好隐私保护搜索、避免个性化追踪的用户
- 构建 AI Agent 时需要可靠搜索能力的开发者
常规风险
- API 费用：高频调用可能产生超出免费额度的成本
- 时效盲区：
--freshness过滤依赖索引时间，非真正实时抓取 - 引用缺失：AI 摘要模式不强制标注信息来源，学术/医疗等场景需谨慎使用