前言¶
Agent 需要查文档、核对事实或拉取网页正文时，常见做法是开浏览器自动化或手写爬虫。前者重、易碎，后者还要自己处理反爬与正文抽取。若你希望用 API 完成「搜索 + 可选正文提取」，且不想在环境里挂完整浏览器，可以看看基于 Brave Search API 的 Brave Search Skill。
下面介绍这个 Skill 的定位、能力与安装方式，并给出上游仓库里可复现的命令示例。
这是什么¶
Brave Search Skill（SkillHub 坐标 @clawhub_steipete/brave-search，当前版本 1.0.1）通过 Brave Search API 做网页搜索与内容提取，面向「搜文档、查事实、拉任意网页内容」一类任务；说明里强调轻量级、无需浏览器。
- 来源：clawhub，发布者 steipete（上游页面为 Peter Steinberger @steipete）
- 分类：knowledge-management（知识管理）
- 标签：
requires_api_key=true（需要配置 API Key） - SkillHub 页面：https://www.skillhub.cn/skills/clawhub_steipete/brave-search
- 上游仓库：https://clawhub.ai/steipete/brave-search
- API 入口：https://api.skillhub.cn/zcwl/brave-search
SkillHub 上该 Skill 的简介与上游一致：经 Brave Search API 进行网页搜索与内容提取，适用于搜索文档、事实或任何网页内容。
核心功能¶
根据 SkillHub 与 ClawHub 上游说明，可核实的能力包括：
- 网页搜索：用查询词检索 Web 结果（默认条数可由参数控制）。
- 可选正文提取：搜索时可带上标志，把命中页面的可读内容以 Markdown 形式一并返回。
- 单 URL 正文提取：对指定 URL 抓取并抽取可读正文（Markdown）。
- 无头运行：不依赖交互式浏览器，适合在脚本或 Agent 工作流里调用。
输出格式在上游文档中有示例：每条结果包含 Title、Link、Snippet；使用 --content 时会附加从页面提取的 Markdown 内容块。
安装与启用¶
通过 SkillHub 安装（国内常用）¶
SkillHub 页面给出的安装指引是：先阅读 SkillHub 安装与优先源配置，再安装坐标 @clawhub_steipete/brave-search。
1、确认本机已有 skillhub CLI（未安装时可按官方文档执行安装脚本）：
command -v skillhub && skillhub --version
2、安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：
skillhub install clawhub_steipete/brave-search --dir <skills 目录>
SkillHub 文档中列出的部分客户端 skills 路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装或更新 skills 后，按你所用客户端的说明重启或刷新 Agent，使新 Skill 生效。
通过 ClawHub / OpenClaw 安装¶
上游 ClawHub 页面提供的安装命令为：
openclaw skills install @steipete/brave-search
API Key 与依赖¶
上游 Setup 写明：
- 首次使用前需在 Skill 所在目录执行
npm ci（示例路径为~/Projects/agent-scripts/skills/brave-search，实际以你安装后的目录为准）。 - 环境变量：
BRAVE_API_KEY（Brave Search API 密钥）。
未配置有效 Key 时，搜索与提取请求无法通过 API 完成。
典型用法¶
以下命令来自 ClawHub 上游仓库说明，在已 npm ci 且配置 BRAVE_API_KEY 的前提下使用（脚本名与路径以安装后的 Skill 包为准）。
基础搜索（默认约 5 条结果）：
./search.js "query"
调整结果数量：
./search.js "query" -n 10
搜索并附带页面 Markdown 正文：
./search.js "query" --content
./search.js "query" -n 3 --content
对单个 URL 提取正文：
./content.js https://example.com/article
Agent 侧启用该 Skill 后，可将上述能力封装进对话：例如让模型「查某 API 官方文档并摘录要点」，由 Skill 指导调用搜索或 content.js 拉取页面。
适用场景与注意¶
适合：
- 查文档、API 参考、技术事实，需要 Web 检索但不想起浏览器。
- 已知 URL，需要可读 Markdown 正文做摘要或引用。
- 工作流里需要「隐私优先」的搜索 API 方案（Skill 简介与英文说明均指向 Brave Search API）。
注意：
- 必须自备 Brave Search API 密钥（
requires_api_key=true）。 - 依赖 Node 生态：上游要求在该 Skill 目录执行
npm ci。 - 搜索结果条数、是否拉全文由参数控制，拉全文会增加 API 调用与耗时。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 89167，安装 7921；具体数字以 SkillHub 页面实时显示为准。
结尾¶
Brave Search Skill 把「搜索 + 可选正文提取」收敛到 Brave Search API 与少量脚本命令，适合给 Agent 补 Web 检索能力且控制环境复杂度。安装与坐标以 SkillHub 为准，行为与命令示例以 ClawHub 上游为准。
- SkillHub API / 索引：https://api.skillhub.cn/zcwl/brave-search
- SkillHub 详情页：https://www.skillhub.cn/skills/clawhub_steipete/brave-search
