Brave API 搜索

使用官方 Brave Search API 进行实时网络搜索、自动补全和 AI 驱动的答案。提供三种工具：

• brave_search—— 提供包含标题、URL、描述和可选 AI 摘要的网络搜索结果
• brave_suggest—— 在用户输入时提供查询自动补全建议，可选择包含丰富的元数据
• brave_answers—— 基于实时网络搜索、提供内联引用的 AI 支持答案

设置

在本地.env文件中设置您的 Brave API 密钥（推荐）：

# .env (do not commit)
BRAVE_SEARCH_API_KEY=your_key_here
BRAVE_ANSWERS_API_KEY=your_key_here

或在需要时在您的 shell 会话中导出它们。

在此处获取您的密钥：https://api-dashboard.search.brave.com

如果您的套餐同时支持搜索和 AI 答案端点，这两个密钥可以相同。

注意：brave_search和brave_suggest使用BRAVE_SEARCH_API_KEY。brave_answers需要BRAVE_ANSWERS_API_KEY。

注意：此技能明确要求BRAVE_SEARCH_API_KEY和BRAVE_ANSWERS_API_KEY。它不使用通用的BRAVE_API_KEY作为后备。

何时使用此技能

在以下情况下使用brave_search：

• 搜索当前信息、新闻或近期事件时
• 查找文档或技术参考资料时
• 需要带URL的排名结果以便后续跟进时
• 想要获取搜索结果的AI摘要时

使用brave_suggest适用场景：

• 搜索界面中的智能自动补全
• 帮助用户更快更好地构建查询
• 需要在用户输入时提供查询补全建议
• 希望建议包含丰富的元数据（标题、描述、图片）

使用brave_answers适用场景：

• 需要包含引用来源的综合答案
• 研究能从多个来源获益的主题
• 希望获得附带内联引用的AI生成回答
• 需要深度研究模式（多重搜索）

不适用于：

• 已通过上下文或记忆回答的问题
• 不需要外部信息的任务

工具

brave_search

返回带有标题、URL和描述的排名结果的网络搜索。

brave_search(query="latest Node.js release", count=5)
brave_search(query="TypeScript generics", extra_snippets=true)
brave_search(query="current weather Copenhagen", freshness="pd")
brave_search(query="React Server Components", summary=true)

参数：

• 查询（必需）— 搜索查询，支持运算符：site:,"精确短语",-排除
• count— 返回结果数量（1-20，默认：10）
• country— 2字母国家代码（默认：us）
• freshness— 日期过滤器：pd（24小时），pw（7天），pm（31天），py（1年）
• extra_snippets— 每个结果最多包含5个额外文本摘要（默认：false）
• summary— 获取Brave AI摘要生成结果（默认值：false）

返回：包含标题、网址、描述及可选AI摘要的格式化结果列表。

brave_suggest

查询自动补全API，在用户输入时提供智能查询建议。

brave_suggest(query="hello")
brave_suggest(query="pyt", count=5, country="US")
brave_suggest(query="einstein", rich=true)

参数：

• query（必填）— 需要获取建议的部分查询内容
• count— 建议数量（1-10，默认值：5）
• country— 2位国家代码（默认：US）
• rich— 包含增强元数据：标题、描述、图像、实体识别（默认值：false，需要付费计划）

返回：查询建议列表，可选包含丰富元数据。

最佳实践：

• 建议实现防抖机制（150-300毫秒），避免用户输入时触发过多API调用
• 以异步方式加载建议，不阻塞用户界面

brave_answers

基于实时网络搜索并附带行内引用的AI驱动答案。

brave_answers(query="How does React Server Components work?")
brave_answers(query="Compare Postgres vs MySQL for OLAP", enable_research=true)
brave_answers(query="Latest Python release notes", enable_citations=true)

参数：

• query（必需）— 要研究的问题或主题
• enable_citations— 是否包含行内来源引用（默认值：true）
• enable_research— 多搜索深度研究模式（默认值：false）
• country— 搜索内容的目标国家/地区（默认值：us）

返回：包含从响应中提取的引用来源的AI答案，以及令牌使用情况。

定价与限制

Brave的定价基于积分制且可能变动。请不要假定有固定的免费请求次数。

当前公开指导（在生产使用前，请在Brave控制台/文档中核实）：

• 可能会提供月度试用额度（例如每月5美元的额度）
• 搜索和答案功能消耗额度的方式不同
• 丰富的建议功能需要付费的自动建议套餐
• 答案功能也可能包含基于令牌的成本
• 每秒查询次数限制取决于您的套餐等级

请始终在以下网址检查您的实时限制和使用情况：

• https://api-dashboard.search.brave.com
• https://brave.com/search/api/

安全与打包说明

• 此技能仅调用位于https://api.search.brave.com/res/v1下的Brave官方端点
• 。它需要恰好两个环境变量：BRAVE_SEARCH_API_KEY和BRAVE_ANSWERS_API_KEY（请将它们保存在.env
• 它不需要持久的/系统权限，也不修改系统配置。
• 它基于源文件（三个本地Node脚本），无需外部安装/下载步骤。

API与网页抓取

此技能使用官方的Brave搜索API而非网页抓取。优势包括：

• 可靠、结构化的JSON响应
• 速率限制标头和适当的错误信息
• 可访问AI摘要器、AI答案和自动建议端点
• 符合服务条款