---
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."
license: "MIT"
metadata:
  decimalai-skill-id: "f844c262-dbb5-4def-b5a6-37a1d1bb0aab"
  decimalai-version-id: "720dca13-46e2-4557-bae8-e4c4bb07e000"
  decimalai-version: "1"
  decimalai-body-sha256: "fce11465624753dd1f6db4bdc5e5ae22013806753e6bb407f20832b39746941b"
  decimalai-name: "brave-search"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "research"
  decimalai-source: "https://app.decimal.ai/s/brave-search@1/SKILL.md"
---
# Brave Search

Headless web search and content extraction using Brave Search. No browser required.

## Setup

Run once before first use:

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

Needs env: `BRAVE_API_KEY`.

## Search

```bash
./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
```

## Extract Page Content

```bash
./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
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