核心功能与用法
Brave API Search Skill 提供两类互补工具：
`brave_search` — 标准网络搜索，返回带标题、URL、描述的排序结果列表。支持时间过滤（24小时至1年）、国家区域定制、额外摘要片段获取，以及可选的AI结果汇总。适用于查找文档、新闻、技术资料等场景。
`brave_answers` — AI驱动的答案生成，基于实时搜索结果提供带内联引用的合成回答。支持深度研究模式（多轮搜索聚合）和引文开关，适合需要溯源、对比分析或复杂议题调研的场景。
典型调用示例：
- 技术文档检索：
brave_search(query="React Server Components", summary=true) - 时效性信息：
brave_search(query="latest Node.js release", freshness="pd") - 深度研究：
brave_answers(query="Compare Postgres vs MySQL for OLAP", enable_research=true)
显著优点
1. 官方API可靠性：非爬虫方案，提供结构化JSON响应、标准速率限制头与合规保障
2. 双模式灵活切换：精准检索与生成式问答分离，按需选择工具
3. AI原生设计：内置Brave AI摘要器与带引用的答案引擎，降低幻觉风险
4. 精细化控制：支持搜索运算符（site:、精确短语、排除词）、时间过滤、地域定制
5. 透明溯源：AI答案附带可验证的引用来源，提升可信度
局限性与注意事项
- 双密钥依赖：需分别配置
BRAVE_SEARCH_API_KEY与BRAVE_ANSWERS_API_KEY，不支持单密钥回退 - 信用计费模式：Brave采用信用额度制（非固定免费额度），Search与Answers消耗信用不同，Answers还可能产生token费用，生产环境需实时监控额度
- 地理覆盖限制：搜索地域以国家代码粒度配置，无法精确到城市层级
- API可用性绑定：功能完全依赖Brave服务可用性与政策稳定性
适用人群
- 开发者需要实时技术文档检索
- 研究人员进行多源信息聚合与溯源分析
- 内容创作者验证事实、获取最新资讯
- 任何需要替代传统搜索引擎API（如Google Custom Search）的AI应用场景
常规风险提示
| 风险类型 | 说明 |
|---------|------|
| 成本失控 | 深度研究模式（enable_research）可能触发多轮搜索，需关注信用消耗 |
| 密钥管理 | 环境变量暴露风险，遵循最小权限原则部署 |
| 结果时效性 | `freshness`参数过滤的是索引时间非实际发布时间，关键时效信息建议交叉验证 |
| AI幻觉 | 尽管有引用机制，复杂议题仍建议人工复核来源 |
| 服务依赖 | Brave政策或定价变更可能影响可用性与成本结构 |