Brave Search API

快速结论

Brave Search API 是给开发者调用的搜索数据服务，不是给普通用户直接输入关键词的搜索网页。它把 Brave 的网页索引、新闻、图片、视频、本地地点、查询建议、拼写纠正、面向模型的 LLM Context，以及带来源的 Answers 能力开放为 API，适合给 RAG、研究助手、客服机器人和自动化 Agent 增加公开网络检索。若你只是自己查资料，应使用独立的 Brave Search 消费者产品；如果产品要稳定解析具体网页，可同时比较 Firecrawl；需要其他 Agent 搜索接口，可比较 Tavily 与 Exa。

截至 2026-07-21，Brave 还维护官方 MCP Server 与 Agent Skills，两者均采用 MIT 许可证，能减少手写接入代码。但这只授权集成软件，不会把 Brave API 服务、搜索结果数据、网页内容或图片变成 MIT 数据。正式上线前必须建立四条边界：查询不得携带不必要的个人或商业秘密；API Key 只能放在服务端或受控密钥存储中；缓存、再分发和训练用途要按当前 API 条款及所购计划核对；最终答案必须保留来源核验与失败降级。本站不把它标为默认推荐，因为地区可用性、中文召回、合同权利和持续用量成本都需要项目级实测。

核心功能

• Web Search：返回排序后的网页标题、URL、摘要及可选过滤参数，适合构建搜索页和检索管线。
• LLM Context：为模型准备预提取的网页片段，并可限制 URL、片段与近似 token 数，更接近 RAG 和 Agent 的输入需求。
• Answers：通过兼容 OpenAI Chat Completions 形态的接口生成带依据的回答，可选择单次检索或研究模式。
• 新闻、图片与视频：按媒体类型检索新内容和元数据；结果中的缩略图或链接不等于获得转载、下载或商用许可。
• 本地地点、建议与拼写：提供地点详情、查询建议和拼写纠正等搜索产品组件，部分能力可能依赖特定计划。
• Goggles 重排：按站点或规则提升、降低和过滤结果，适合把检索范围收敛到可信来源集合。
• 官方 MCP Server：支持 stdio 与 HTTP，将搜索、LLM Context、地点和摘要等能力暴露为 MCP 工具。
• 官方 Agent Skills：为 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等支持 Agent Skills 的客户端提供现成调用说明。

适合人群

• 要给聊天机器人或内部研究助手增加实时公开网络检索的开发团队。
• 需要独立搜索索引，并愿意自行做评测、缓存、引用、预算和合规控制的 RAG 工程师。
• 想通过 MCP 或 Skills 快速验证搜索工具调用的 Agent 开发者。
• 需要网页、新闻、图片、视频或地点等多种搜索端点的产品团队。
• 不适合只想找一个免费搜索框、不能保护密钥、需要永久复制搜索索引，或无法核对内容授权的项目。

使用场景

一个稳妥的 RAG 流程通常先把用户问题去除账号、客户名和未公开项目细节，再调用 LLM Context 或 Web Search。系统保存查询时间、参数、URL 与必要的结果标识，但不默认永久复制全部响应。模型生成答案后，界面展示可打开的来源，并对无结果、来源冲突、时效不足和接口限流给出明确状态。医疗、法律、金融和安全决策还必须转交具备资质的人复核。

Agent 接入时，官方 MCP Server 和 Skills 能节省工具描述与参数映射工作，但也扩大了密钥和外部内容进入模型上下文的范围。MCP 服务应默认走 stdio 或绑定本机回环地址；如果改为 HTTP 并监听外部接口，必须增加认证、来源限制和网络隔离。网页摘要可能包含提示注入、恶意指令或伪造数据，Agent 不应把搜索结果当成系统指令，也不应因网页要求而读取本地文件、泄露密钥或执行命令。

价格与版本

使用 Brave Search API 需要创建 API 账号、选择当前可用计划，并从开发者控制台生成 Key。服务按计划和端点计量，Web Search、LLM Context、Answers 与其他搜索类型的计费单位、速率限制和可用能力可能不同。2026-07-21 无法从公开页面可靠确认一个对所有新账号都适用的固定免费赠送金额，因此本文不沿用旧页面中的“每月 2000 次”数字，也不把试用余额写成长期承诺。

目录继续使用“免费增值”分类，是因为控制台可能存在试用或免费信用路径；生产预算应按零免费额度估算，再把账号实际显示的赠送信用当作临时抵扣。压测时分别记录成功请求、重试、Answers 的研究模式、LLM Context 返回规模和高峰并发。套餐升级前还要核对限流、超额行为、支持级别、数据处理条款与取消方式，不要只比较每千次调用的标价。

国内访问与使用体验

Brave Search API 属于境外服务，官网、控制台和 API 在不同地区或网络环境下可能不可达或不稳定。本文只记录这一访问条件，不提供任何网络线路建议。中国团队应在计划使用的云区域、办公网络和移动网络上分别验证 DNS、TLS、延迟、超时、限流和付款流程，并准备明确的超时、熔断、重试上限与备用数据源。

中文查询并非不能使用，但长尾中文网页、本地生活、中文社区、新页面时效和地域排序需要单独建立评测集。至少准备导航、事实、近期新闻、专业术语、地域服务和反事实查询，记录召回率、重复结果、来源质量与答案引用正确性。API 返回的是候选资料，不是事实保证；产品仍要检查发布日期、原始出处和不同来源是否实际独立。

优点

• 搜索数据来自 Brave 的独立索引路线，可减少对单一大型搜索生态的依赖。
• Web、新闻、图片、视频、地点、LLM Context 和 Answers 覆盖面较完整。
• LLM Context 能减少开发者自行抓取和切分公开网页的前期工作。
• 官方 MCP Server 与 Agent Skills 都在 Brave 组织下维护，接入路径清晰。
• MCP 和 Skills 代码使用 MIT 许可证，便于审查、修改和自托管集成层。
• Goggles 为自定义来源范围和重排提供了少见的可编程入口。

不足

• API 是计量服务，搜索、上下文和答案链路的完整成本要用真实流量计算。
• 固定免费信用无法可靠确认，旧版免费额度不应继续用于预算。
• 中文长尾、本地与地域结果需要额外评测，不能从英文表现推断。
• API Key、用户查询、返回内容和缓存都会进入新的安全与合规边界。
• MIT 只覆盖官方开源集成代码，不覆盖 API 数据、第三方网页和图片权利。
• 外部网页可包含错误信息或提示注入，Agent 工具调用必须有权限护栏。

替代品对比

常见问题 FAQ

Brave Search API 和 Brave Search 是同一个产品吗？

不是。API 面向开发者，需要账号、Key、计划和程序调用；Brave Search 是普通用户在浏览器中使用的搜索界面。两者共享 Brave 搜索能力，但计费、条款和数据处理边界不同。

Brave Search API 有固定免费额度吗？

截至本文日期，无法可靠确认适用于所有新账号的统一固定免费信用。应以自己的控制台和结算页面为准，生产预算按没有赠送额度计算。

官方 MCP Server 和 Agent Skills 都是 MIT 吗？

是，Brave 的这两个集成仓库标注为 MIT。但许可证只覆盖仓库里的软件与文档，不会授予搜索 API 数据或第三方网页、图片的再利用权。

API Key 可以放在浏览器前端或公开仓库吗？

不可以。Key 应放在服务端密钥管理、受控环境变量或受权限保护的本地配置中，并设置轮换、最小权限、用量告警和泄露后的吊销流程。

可以长期缓存和重新分发全部搜索结果吗？

不能凭技术上可缓存就假定有此权利。缓存期限、展示、再分发、训练和建立衍生索引应按当前 API 条款、购买计划及原始内容权利逐项确认；HTTP 缓存头也不能替代合同授权。

搜索结果可以让 Agent 自动执行操作吗？

可以作为决策输入，但不应直接获得高风险执行权。网页内容可能错误、过时或包含提示注入，涉及发消息、付款、删除数据、运行命令和发布内容时应要求人工确认。

总结

Brave Search API 的核心价值是把独立搜索索引、多类型结果、面向模型的上下文与答案能力放进一个开发者接口，并提供官方 MCP 和 Skills 集成。它不是“装上就可信”的联网按钮。合格的生产接入必须同时管理搜索质量、引用、Key、查询隐私、缓存权利、第三方内容许可、提示注入、地区可用性和计量成本。先用代表真实业务的中英文查询做小规模评测，再决定是否进入主链路；只需要人工搜索时，直接使用消费者 Brave Search 会更简单。