# Brave Search

> Web search via the Brave Search API. Use to retrieve search results from Brave when web lookups are needed.

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

---


# Brave Search

## Usage

```bash
uv run --script {thisSkillDir}/scripts/brave-search.py "QUERY" [OPTIONS] --json
```

## Options

- `--count <N>`: Maximum results to return (default: 5)
- `--offset <N>`: Offset into the result set (default: 0)
- `--country <CODE>`: Two letter country code
- `--search-lang <CODE>`: Search language code
- `--safesearch <off|moderate|strict>`: Safe search mode
- `--freshness <day|week|month>`: Filter by recency
- `--json`: Output normalized JSON
- `--raw`: Output raw API response
- `--help`: Show help

## Examples

```bash
uv run --script {thisSkillDir}/scripts/brave-search.py "observability tools" --count 3 --json
```