# Brave Search API

> This skill enables web searching using Brave Search API directly via curl. Use when searching for current information, news, articles, or web content. MCP server not required - calls API directly. Use when this capability is needed.

- Skill: `tomevault-io/brave-search-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/brave-search-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/brave-search-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/brave-search-api

---


# Brave Search API (Direct)

## Overview

This skill enables web searching using the Brave Search API directly via curl commands. No MCP server required - saves context tokens.

## API Key

Environment variable: `BRAVE_API_KEY`

## Web Search

### Endpoint
```
GET https://api.search.brave.com/res/v1/web/search
```

### Parameters
- `q` (required): Search query
- `count` (optional): Results count (1-20, default 10)
- `offset` (optional): Pagination offset

### Usage

Generate and execute this curl command:

```bash
curl -s "https://api.search.brave.com/res/v1/web/search?q=QUERY&count=10" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"
```

### Example

```bash
curl -s "https://api.search.brave.com/res/v1/web/search?q=xterm.js+WebGL+tutorial&count=5" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: $BRAVE_API_KEY" | jq '.web.results[] | {title, url, description}'
```

## Local Search

### Endpoint
```
GET https://api.search.brave.com/res/v1/local/search
```

### Usage

```bash
curl -s "https://api.search.brave.com/res/v1/local/search?q=coffee+near+Shibuya" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"
```

## Response Processing

Use `jq` to extract relevant fields:

```bash
# Get titles and URLs
| jq '.web.results[] | {title, url}'

# Get descriptions
| jq '.web.results[] | {title, description}'

# Get first 3 results
| jq '.web.results[:3]'
```

## Common Workflows

### Research a Technology
```bash
curl -s "https://api.search.brave.com/res/v1/web/search?q=VS+Code+extension+development+2024&count=10" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: $BRAVE_API_KEY" | jq '.web.results[:5] | .[] | {title, url}'
```

### Find Error Solutions
```bash
curl -s "https://api.search.brave.com/res/v1/web/search?q=WebGL+context+lost+solution&count=10" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: $BRAVE_API_KEY" | jq '.web.results[] | {title, url, description}'
```

## Notes

- URL encode spaces as `+` or `%20`
- API key must be set in environment
- Rate limits apply per subscription tier

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/s-hiraoku) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->