总安装量 121
评分人数 110
核心用法
Brave Search 是一款轻量级命令行工具，提供两大核心功能：网络搜索与网页内容提取。用户可通过 ./search.js 执行关键词搜索，支持自定义结果数量（-n 参数）和内容抓取（--content 标志），输出包含标题、链接、摘要及可选的 Markdown 格式正文。./content.js 则专注于单 URL 内容提取，将任意网页转换为可读性强的 Markdown 文档。使用前需配置 BRAVE_API_KEY 环境变量并执行 npm ci 安装依赖。
显著优点
1. 无浏览器架构：基于 Node.js 和 jsdom 实现，无需启动 Chromium 等重型浏览器，资源占用极低，启动速度快。
2. 内容结构化：集成 Mozilla Readability 和 Turndown，自动提取正文并转换为标准 Markdown，便于后续处理或知识库归档。
3. 开发者友好：纯命令行交互，输出格式清晰，易于集成到自动化脚本、CI/CD 流程或 AI Agent 工作流中。
4. 依赖精简：仅依赖 4 个生产级开源库，均为社区广泛验证的成熟方案，维护成本低。
潜在缺点与局限性
- 功能边界明确：不支持 JavaScript 动态渲染页面，对 SPA（单页应用）或重度依赖前端框架的网站内容提取可能不完整。
- 网络依赖性强：完全依赖 Brave Search API 的可用性和配额限制，无本地缓存或离线能力。
- 无交互能力：纯只读工具，无法执行登录、表单提交等需要状态保持的操作。
- 内容截断：默认限制 5000 字符输出，长文可能需要多次请求或调整参数。
适合的目标群体
- 开发者与工程师：快速检索技术文档、API 参考、错误解决方案
- 研究人员：批量收集学术资料、新闻资讯并整理为 Markdown
- AI Agent 与自动化系统：作为 RAG（检索增强生成）流程的信息源组件
- 内容创作者：高效采集网络素材进行再加工
使用风险
- 服务可用性：Brave API 服务中断或速率限制将直接影响功能
- 内容准确性：提取内容依赖源网站结构，复杂布局可能导致信息丢失或错位
- 依赖更新：jsdom 等底层库的安全更新需及时跟进，建议按报告建议每 90 天审查依赖