SuperAPI AI 工具集

brave-search

通用与其它

查看项目

更新于 10-16 06:56

技能介绍

用途

Brave Search 是一个命令行式的无头网页搜索与内容提取工具,基于 Brave Search API。它的定位是无需浏览器即可完成搜索和抓取,适合自动化流程或纯文本环境中的检索需求。可用于搜索文档或 API 参考、查询事实或当前信息、从指定 URL 获取内容,以及任何需要网页搜索但不进行交互式浏览的任务。

主要能力

  • 网页搜索:通过 search.js 执行查询,默认返回 5 条结果。
  • 结果数量控制:使用 -n 参数调整返回结果数量,例如 -n 10。
  • 内容提取:使用 --content 参数将页面内容以 Markdown 形式包含进结果。
  • 指定 URL 抓取:通过 content.js 获取某个 URL 并提取可读内容为 Markdown。
  • 无浏览器依赖:整个工具为轻量实现,不需要浏览器。

使用方式

首次使用前需运行一次安装命令:

cd ~/Projects/agent-scripts/skills/brave-search
npm ci

该工具需要环境变量 BRAVE_API_KEY。

搜索示例:

./search.js "query"                    # Basic search (5 results)
./search.js "query" -n 10              # More results
./search.js "query" --content          # Include page content as markdown
./search.js "query" -n 3 --content     # Combined

提取页面内容示例:

./content.js https://example.com/article

输出格式示例:

--- 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 ---
...

适用场景

  • 搜索文档或 API 参考。
  • 查找事实或当前信息。
  • 从特定 URL 抓取内容。
  • 任何需要网页搜索但不进行交互式浏览的任务。

限制

资料未提供关于调用频率、结果条数上限、目标网站兼容性或内容提取范围的具体限制说明。依赖 Brave Search API,需要有效的 BRAVE_API_KEY;未提供该密钥时无法使用。除上述命令行参数与输出格式外,资料未说明其他配置项或运行环境要求。