@firstpick/pi-extension-brave-search

Brave Search tool for Pi with API key resolution from env and .env files.

Packages

Package details

extension

Install @firstpick/pi-extension-brave-search from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@firstpick/pi-extension-brave-search
Package
@firstpick/pi-extension-brave-search
Version
0.1.9
Published
May 19, 2026
Downloads
1,132/mo · 522/wk
Author
firstpick
License
MIT
Types
extension
Size
19.3 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extension-brave-search

Brave Search tool integration for Pi.

What it does

  • Adds the brave_search tool for live web search from Pi.
  • Returns formatted results plus structured metadata.
  • Supports Brave result filters, extra snippets, spellcheck, clean text output, and Goggles.
  • Deduplicates normalized URLs across returned result blocks.
  • Applies sane limits and request pacing to keep output stable, context-safe, and compatible with low-rate plans.
  • Resolves API key in this order:
    1. process.env.BRAVE_SEARCH_API_KEY
    2. ./.env (current working directory)
    3. PI_CODING_AGENT_DIR/.env

Install

pi install npm:@firstpick/pi-extension-brave-search

Configuration

  • BRAVE_SEARCH_API_KEY (required)

If no key is configured when Pi starts, the extension prompts you to enter one and choose where to save it:

  • current workspace: ./.env
  • global Pi config: $PI_CODING_AGENT_DIR/.env or ~/.pi/agent/.env

Commands

  • /brave-search-status — show whether Brave Search is configured and where key resolution succeeded.
  • /brave-search-setup — run the interactive setup prompt again when no key is configured.
  • /brave-search-results — show and adjust the default web result count saved as BRAVE_SEARCH_RESULT_COUNT.

Tools

  • brave_search
    • Inputs: query, optional count, country, search_lang, freshness, safesearch, result_filter, extra_snippets, spellcheck, text_decorations, goggles
    • Output: formatted search results + metadata, including responseTypes, requested web result count, count warning, canonical URLs, result type, original index, duplicate count, and optional extra snippets

Useful result_filter values include web, news, videos, faq, discussions, infobox, and locations. count applies to web results only in Brave's API. Brave Web Search supports count from 1 to 20 per request; the extension warns at 16+ and clamps invalid saved defaults into the supported range.

Example view

brave_search "Brave Search API documentation" (2 results)
 1. Documentation - Brave Search API
 https://api-dashboard.search.brave.com/documentation
 Access billions of web pages with our core search API. Includes local results and rich content enhancements.

 2. Brave Search API | Brave
 https://brave.com/search/api/
 Enterprise-grade Web search API accessing an index of 40+ billion pages.
 Age: 1 month ago

The query is shown directly in the tool header, so it is easy to see what Pi searched for before reading the results.