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:

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.