用途:调用 Brave Search 的 Web Search 接口执行网页搜索,返回结构化排序结果(标题、URL、摘要、缩略图、发布者等),适合搜索界面、数据提取和自定义排序场景。需要 API Key,可在 https://api.search.brave.com 获取,包含在 Search 套餐中。
主要能力:支持 GET/POST 请求;可通过 result_filter 过滤 web、news、videos、discussions、faq、infobox、locations 等结果类型;支持 freshness 时效过滤(pd/pw/pm/py 或日期范围)、SafeSearch、分页(offset 0-9、count 1-20)。独有 Goggles 自定义排序,可提升或丢弃指定站点结果。支持搜索运算符(site:、filetype:、intitle: 等)。返回结果可含 schema.org 结构化数据(产品、食谱、文章、影评等)。enable_rich_callback 可对天气、股票、汇率等查询启用丰富数据回调。
用法:GET 或 POST https://api.search.brave.com/res/v1/web/search,请求头携带 X-Subscription-Token: <API_KEY>。示例:curl -s "https://api.search.brave.com/res/v1/web/search?q=python+web+frameworks" -H "Accept: application/json" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"。丰富数据经 https://api.search.brave.com/res/v1/web/rich 配合 callback_key 获取。位置感知可加 X-Loc-Lat、X-Loc-Long 等请求头。
适用场景:搜索 UI、结构化数据抽取、Goggles 定制排序、位置感知查询。做 RAG 或 LLM 接地时官方建议改用 llm-context;需要端到端 AI 答案可用 answers。
限制:q 长度 1-400 字符、最多 50 词;count 上限 20,实际结果可能少于请求数;托管 Goggles 需位于 GitHub/GitLab 并注册;免费与付费额度、具体价格暂未提供。