Brave Search 是一个无头(headless)网页搜索与内容提取工具,基于 Brave Search API 实现,无需浏览器即可运行。它适用于搜索文档、事实或任意网页内容,也可用于从特定 URL 抓取正文。
主要能力
搜索:通过命令行执行查询,默认返回 5 条结果,可用 -n 参数指定结果数量,用 --content 参数附带页面正文。
内容提取:给定一个 URL,抓取该页面并提取可读内容,输出为 Markdown 格式。
输出格式
搜索结果按条目依次输出,每条包含标题(Title)、链接(Link)、摘要(Snippet),若使用 --content 参数还会包含从页面提取的 Markdown 正文内容。
使用方式
首次使用前需运行一次安装命令:
cd ~/Projects/agent-scripts/skills/brave-search npm ci
需要配置环境变量:BRAVE_API_KEY。
搜索命令示例:
./search.js "query" # 基础搜索(5 条结果) ./search.js "query" -n 10 # 更多结果 ./search.js "query" --content # 附带页面正文(Markdown) ./search.js "query" -n 3 --content # 组合使用
提取页面内容命令示例:
./content.js https://example.com/article
适用场景
搜索文档或 API 参考;查询事实或当前信息;从特定 URL 获取内容;任何需要网页搜索但无需交互式浏览的任务。
限制
需要有效的 BRAVE_API_KEY 环境变量;使用前需完成依赖安装;具体收费、价格、平台支持范围等资料暂未提供。