brave-search

name	brave-search
description	Web search via the Brave Search API. Use to retrieve search results from Brave when web lookups are needed.
compatibility	Requires env. variable BRAVE_SEARCH_API_KEY and uv with Python 3.12+.

Brave Search

Usage

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

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