brave-search

📄 文档处理

访问 GitHub

通过集成搜索引擎实现高效的网络信息检索与内容提取，支持多条件筛选和指定页面的结构化数据获取，适用于技术文档查询、事实核对及实时资讯收集等场景，无需浏览器即可完成自动化信息采集。

简介

核心能力速览

✓所属分类：📄 文档处理

✓通过 Agent Skills 协议，将「能力」封装为可复用、可安装的 AI 组件

✓支持按需加载领域知识与工具，让通用模型转变为特定任务的专家

适用场景

适用于「📄 文档处理」相关场景，可作为可复用的 AI 能力组件，接入支持 Agent Skills 的 AI 客户端（如 Claude、Cursor、Cline 等），按需调用以扩展模型能力。

Skills.MD

name	brave-search
description	Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

Brave Search

Web search and content extraction using the official Brave Search API. No browser required.

Setup

Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).

Create an account at https://api-dashboard.search.brave.com/register
Create a "Free AI" subscription
Create an API key for the subscription
Add to your shell profile (~/.profile or ~/.zprofile for zsh):
```
export BRAVE_API_KEY="your-api-key-here"
```
Install dependencies (run once):
```
cd {baseDir}
npm install
```

Search

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results (max 20)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" --freshness pw          # Results from last week
{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
{baseDir}/search.js "query" --country DE            # Results from Germany
{baseDir}/search.js "query" -n 3 --content          # Combined options

Options

-n <num> - Number of results (default: 5, max: 20)
--content - Fetch and include page content as markdown
--country <code> - Two-letter country code (default: US)
--freshness <period> - Filter by time:
- pd - Past day (24 hours)
- pw - Past week
- pm - Past month
- py - Past year
- YYYY-MM-DDtoYYYY-MM-DD - Custom date range

Extract Page Content

{baseDir}/content.js https://example.com/article

Fetches a URL and extracts readable content as markdown.

Output Format

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

When to Use

Searching for documentation or API references
Looking up facts or current information
Fetching content from specific URLs
Any task requiring web search without interactive browsing

快捷安装

在终端执行以下命令，即可将本 Skill 安装到本地 AI 客户端：

npx skills add badlogic/pi-skills