SKILL.md

brave-search

Agent skill fromAnil-matcha/awesome-muse-connectors

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

install brave-search

# install the awesome-muse-connectors pack with the skills CLI

npx skills add Anil-matcha/awesome-muse-connectors

# or add only this skill to Claude Code: copy the folder

connectors/brave-search/

# into

~/.claude/skills/brave-search/ (all projects)

.claude/skills/brave-search/ (one project)

connectors/brave-search/SKILL.md

MITFull file

1# Brave Search
2 
3## Purpose
4Read-only web search powered by Brave's own independent index. Use when the user mentions Brave or asks for a web search.
5 
6## Tooling
7All commands go through `bin/brave-search.py`:
8 
9```bash
10bin/brave-search.py auth                                  # verify the connection
11bin/brave-search.py search --query "AI agent frameworks" --count 10   # web search
12```
13 
14## Auth
15- Provider id: `brave-search` (credential is collected as `custom.brave-search`)
16- Collection: API key via the secure credential flow (`credentials.request_api_access`)
17- Get a key: brave.com/search/api (free tier: 2,000 queries/month)
18- Allowed hosts: `api.search.brave.com`
19- Status check: `bin/brave-search.py auth` (must return `"ok": true`)
20- Connect placement: `custom_header:X-Subscription-Token`
21 
22## Operating Rules
231. This connector is read-only: it only searches the web. It never writes, modifies, or sends anything on the user's behalf.
242. 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.
253. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the token value.
26 
27## Files
28- SKILL.md
29- bin/brave-search.py
30 
31## Maturity
32🧪 Draft: written from Brave Search's public API docs; not yet live-tested end-to-end.

Excerpt shown under the repository's MIT license.

How to install brave-search

connectors/brave-search/SKILL.md

More skills in awesome-muse-connectors

Newsletter

Join the Community