mcpbeat Sign in

Brave Search Agent Skill

by Anil-matcha

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

440 tokens
context cost
SKILL.md, read when the skill is used
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
1 052
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/Anil-matcha/awesome-muse-connectors --skill brave-search

What comes with it

2 780 bytes besides the instruction
bin/brave-search.py

The instruction itself

7 sections, as written by the author

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

  • This connector is read-only: it only searches the web. It never writes, modifies, or sends anything on the user's behalf.
  • 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.
  • 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.

How to use it

Copy the folder

Take anil-matcha/brave-search from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.