Skill location: /Users/badlogic/.pi/agent/skills/pi-skills/brave-search/SKILL.md References are relative to /Users/badlogic/.pi/agent/skills/pi-skills/brave-search.

Brave Search

Web search and content extraction using the official Brave Search API. No browser required.

Setup

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=[REDACTED]

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

Fetches a URL and extracts readable content as markdown.

Output Format

--- Result 1 ---Title: Page TitleLink: https://example.com/pageAge: 2 days agoSnippet: Description from search resultsContent: (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