brave-search

Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).

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"

```

1. Install dependencies (run once):

```bash

cd {baseDir}

npm install

```

```bash

{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 - Number of results (default: 5, max: 20)
• --content - Fetch and include page content as markdown
• --country - Two-letter country code (default: US)
• --freshness - 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

```bash

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

```

Fetches a URL and extracts readable content as markdown.

```

--- 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 ---

...

```

• 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