brave-search

1# Brave Search
2 
3Web search and content extraction using the official Brave Search API. No browser required.
4 
5## Setup
6 
7Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).
8 
91. Create an account at https://api-dashboard.search.brave.com/register
102. Create a "Free AI" subscription
113. Create an API key for the subscription
124. Add to your shell profile (`~/.profile` or `~/.zprofile` for zsh):
13   ```bash
14   export BRAVE_API_KEY="your-api-key-here"
15   ```
165. Install dependencies (run once):
17   ```bash
18   cd {baseDir}
19   npm install
20   ```
21 
22## Search
23 
24```bash
25{baseDir}/search.js "query"                         # Basic search (5 results)
26{baseDir}/search.js "query" -n 10                   # More results (max 20)
27{baseDir}/search.js "query" --content               # Include page content as markdown
28{baseDir}/search.js "query" --freshness pw          # Results from last week
29{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
30{baseDir}/search.js "query" --country DE            # Results from Germany
31{baseDir}/search.js "query" -n 3 --content          # Combined options
32```
33 
34### Options
35 
36- `-n <num>` - Number of results (default: 5, max: 20)
37- `--content` - Fetch and include page content as markdown
38- `--country <code>` - Two-letter country code (default: US)
39- `--freshness <period>` - Filter by time:
40  - `pd` - Past day (24 hours)
41  - `pw` - Past week
42…