@e9n/pi-brave-search

Brave Search integration for pi — web search via Brave Search API

Package details

← Back
extension

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

npm repohome report
$ pi install npm:@e9n/pi-brave-search
Package
@e9n/pi-brave-search
Version
0.1.1
Published
Apr 26, 2026
Downloads
137/mo · 137/wk
Author
e9n
License
MIT
Types
extension
Size
14.1 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@e9n/pi-brave-search

Web search extension for pi — search the web via the Brave Search API.

Features

  • Web search — query the Brave Search API and get ranked results with titles, URLs, and descriptions
  • Configurable results — set default count (1–20) and override per call
  • Freshness filter — limit results by time range (day, week, month, year, or custom date range)
  • Regional control — filter by country and language
  • Safe search — configurable filtering level (off / moderate / strict)

Setup

  1. Get a Brave Search API key from brave.com/search/api
  2. Add to your pi settings (~/.pi/agent/settings.json):
{
  "pi-brave-search": {
    "apiKey": "BSA..."
  }
}

Settings

Key Type Default Description
apiKey string — Brave Search API subscription token (required)
defaultCount number 5 Default number of results to return (1–20)
safesearch "off" | "moderate" | "strict" "moderate" Safe search filtering level

Tool: search

Search the web using Brave Search.

Parameters

Parameter Type Required Description
query string ✅ Search query
count number — Number of results (1–20, overrides defaultCount)
freshness string — Time filter: pd (day), pw (week), pm (month), py (year), or YYYY-MM-DDtoYYYY-MM-DD
country string — 2-letter country code (e.g. US, NO, GB)
search_lang string — Language code (e.g. en, no)

Install

pi install npm:@e9n/pi-brave-search

License

MIT