Brave Search 是一个基于 Brave Search API 的无头（headless）网页搜索与内容提取工具，根据资料描述，它不需要浏览器即可使用，属于轻量级方案。
用途 该工具主要用于网页搜索和内容提取。资料列出的典型场景包括：搜索文档或 API 参考；查询事实或当前信息；从特定 URL 抓取内容；以及任何需要网页搜索但不需要交互式浏览的任务。
主要能力
- 搜索：通过 search.js 执行查询，默认返回 5 条结果，可用 -n 参数调整结果数量。
- 内容抓取：在搜索时使用 --content 参数，可将页面内容以 Markdown 形式一并返回；也可使用独立脚本 content.js 对指定 URL 抓取并提取可读内容为 Markdown。
- 输出格式：搜索结果按条目编号输出，每条包含 Title（标题）、Link（链接）、Snippet（搜索摘要），若使用 --content 标志还会包含从页面提取的 Markdown 内容。
使用方式 首次使用前需执行一次安装：进入 ~/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 用于抓取 URL 并提取可读内容为 Markdown。
输出示例结构： --- Result 1 --- Title: Page Title Link: https://example.com/page Snippet: Description from search results Content: (if --content flag used) Markdown content extracted from the page...
--- Result 2 --- ...
适用场景 适合需要程序化获取网页信息而不启动浏览器的自动化任务，例如在开发过程中检索文档、在信息核对中查询事实或时效性内容，以及按 URL 拉取正文并按 Markdown 处理。
限制 资料未说明搜索额度、价格、支持平台、语言覆盖、结果排序规则或内容提取的兼容范围；这些信息暂未提供。使用前必须准备 BRAVE_API_KEY，并完成 npm ci 依赖安装。