Brave Search

Setup

1. Create an account at https://api-dashboard.search.brave.com/register
2. Create a "Free AI" subscription
3. Create an API key for the subscription
4. Add to your shell profile (

   ~/.profile

   or

   ~/.zprofile

   for zsh):
   bash

   export BRAVE_API_KEY="your-api-key-here"

5. Install dependencies (run once):
   bash

   cd {baseDir}
   npm install

Search

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results (max 20)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" --freshness pw          # Results from last week
{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
{baseDir}/search.js "query" --country DE            # Results from Germany
{baseDir}/search.js "query" -n 3 --content          # Combined options

Options

• -n <num>

  - Number of results (default: 5, max: 20)

• --content

  - Fetch and include page content as markdown

• --country <code>

  - Two-letter country code (default: US)

• --freshness <period>

  - Filter by time:

  • pd

    - Past day (24 hours)

  • pw

    - Past week

  • pm

    - Past month

  • py

    - Past year

  • YYYY-MM-DDtoYYYY-MM-DD

    - Custom date range

Extract Page Content

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

Output Format

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

--- Result 2 ---
...

When to Use

• Searching for documentation or API references
• Looking up facts or current information
• Fetching content from specific URLs
• Any task requiring web search without interactive browsing