Brave Search

Headless web search and content extraction using Brave Search API. No browser or setup required.

Requirements

• uv (dependencies managed automatically via inline metadata)
• BRAVE_API_KEY environment variable

Search

{baseDir}/search.py "query"                    # Basic search (5 results)
{baseDir}/search.py "query" -n 10              # More results
{baseDir}/search.py "query" --content          # Include page content as markdown
{baseDir}/search.py "query" -n 3 --content     # Combined

Extract Page Content

{baseDir}/content.py https://example.com/article

Fetches a URL and extracts readable content as markdown.

Output Format

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

Special URL Handling (CRITICAL)

DO NOT use Brave Search for these URLs. Use the correct tool instead:

• GitHub URLs: ALWAYS use the gh CLI instead (e.g., gh api, gh repo view, gh issue view, etc.)
• .md file URLs: ALWAYS use curl to fetch the raw file content directly (e.g., curl -sL https://example.com/docs/guide.md)

When to Use

• Searching for documentation or API references
• Looking up facts or current information
• Fetching content from specific URLs (except GitHub URLs or .md files — see above)
• Any task requiring web search without interactive browsing