# Brave Search

Independent web search from Brave's own index.

- Repository: https://github.com/Anil-matcha/awesome-muse-connectors (1403 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Anil-matcha/awesome-muse-connectors --skill brave-search -g -a claude-code -y`
Codex: `npx skills add Anil-matcha/awesome-muse-connectors --skill brave-search -g -a codex -y`
Cursor: `npx skills add Anil-matcha/awesome-muse-connectors --skill brave-search -g -a cursor -y`
Gemini CLI: `npx skills add Anil-matcha/awesome-muse-connectors --skill brave-search -g -a gemini-cli -y`

## Description

Independent web search from Brave's own index. Trigger phrases: brave, brave search, web search.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Brave Search

## Purpose
Read-only web search powered by Brave's own independent index. Use when the user mentions Brave or asks for a web search.

## Tooling
All commands go through `bin/brave-search.py`:

```bash
bin/brave-search.py auth                                  # verify the connection
bin/brave-search.py search --query "AI agent frameworks" --count 10   # web search
```

## Auth
- Provider id: `brave-search` (credential is collected as `custom.brave-search`)
- Collection: API key via the secure credential flow (`credentials.request_api_access`)
- Get a key: brave.com/search/api (free tier: 2,000 queries/month)
- Allowed hosts: `api.search.brave.com`
- Status check: `bin/brave-search.py auth` (must return `"ok": true`)
- Connect placement: `custom_header:X-Subscription-Token`

## Operating Rules
1. This connector is read-only: it only searches the web. It never writes, modifies, or sends anything on the user's behalf.
2. The `--count` parameter is clamped to 1-20 by the CLI; keep it at 10 or fewer unless the user asks for more, to conserve the 2,000 queries/month free tier.
3. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the token value.

## Files
- SKILL.md
- bin/brave-search.py

## Maturity
🧪 Draft: written from Brave Search's public API docs; not yet live-tested end-to-end.