Brave Search 通过 Brave Search 官方 API 提供网页搜索与内容提取能力，使用时不需要浏览器。
用途 该工具主要用于网页搜索，以及从指定 URL 提取可读内容，适合搜索文档、API 参考、事实或当前信息，也适合获取特定网页正文，或用于任何需要网页搜索但不希望进行交互式浏览的任务。
主要能力
- 网页搜索：可返回搜索结果，默认 5 条，最多 20 条。
- 内容包含：在搜索结果中附带页面内容，并以 Markdown 形式呈现。
- 时间筛选：支持按时间段过滤结果，包括过去一天、过去一周、过去一个月、过去一年，或自定义日期范围。
- 国家筛选：支持指定两位国家代码，默认美国。
- 内容提取：可针对指定 URL 抓取并提取可读正文，输出为 Markdown。
使用方式 准备阶段：需要拥有 Brave Search API 账号并创建免费订阅。创建免费订阅需要信用卡，但不会产生费用。步骤包括：在 https://api-dashboard.search.brave.com/register 创建账号，创建 “Free AI” 订阅，为该订阅创建 API Key，然后在 shell 配置文件（~/.profile 或 zsh 的 ~/.zprofile）中添加： export BRAVE_API_KEY="your-api-key-here" 随后安装依赖（只需运行一次）： cd {baseDir} npm install
搜索命令示例： {baseDir}/search.js "query" # 基础搜索（5 条结果） {baseDir}/search.js "query" -n 10 # 更多结果（最多 20 条） {baseDir}/search.js "query" --content # 包含页面内容为 markdown {baseDir}/search.js "query" --freshness pw # 过去一周的结果 {baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30 # 日期范围 {baseDir}/search.js "query" --country DE # 来自德国的结果 {baseDir}/search.js "query" -n 3 --content # 组合选项
搜索选项：
- -n <num>：结果数量（默认 5，最大 20）。
- --content：抓取并以 Markdown 包含页面内容。
- --country <code>：两位国家代码（默认 US）。
- --freshness <period>：按时间过滤，pd 表示过去一天（24 小时），pw 表示过去一周，pm 表示过去一个月，py 表示过去一年，YYYY-MM-DDtoYYYY-MM-DD 表示自定义日期范围。
内容提取命令： {baseDir}/content.js https://example.com/article 该命令会抓取 URL 并提取可读内容为 Markdown。
输出格式 --- Result 1 --- Title: Page Title Link: https://example.com/page Age: 2 days ago Snippet: Description from search results Content: (if --content flag used) Markdown content extracted from the page...
--- Result 2 --- ...
适用场景
- 搜索文档或 API 参考。
- 查找事实或当前信息。
- 从特定 URL 抓取内容。
- 任何需要网页搜索且不需要交互式浏览的任务。
限制
- 需要 Brave Search API 账号、免费订阅与 API Key，否则无法使用。
- 创建免费订阅需要信用卡（资料说明不会收费）。
- 搜索结果数量默认 5，最多 20。
- 其他未在资料中提及的定价、平台支持或效果信息暂未提供。