前言¶
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
