@juicesharp/rpiv-web-tools

Pi extension: lets the model search and read the web via the Brave Search API

Package details

extension

Install @juicesharp/rpiv-web-tools from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@juicesharp/rpiv-web-tools
Package
@juicesharp/rpiv-web-tools
Version
1.1.4
Published
May 3, 2026
Downloads
6,878/mo · 3,491/wk
Author
juicesharp
License
MIT
Types
extension
Size
19.2 KB
Dependencies
0 dependencies · 3 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

rpiv-web-tools

npm version License: MIT

Let the model search the web and read pages. rpiv-web-tools adds web_search and web_fetch tools to Pi Agent, backed by the Brave Search API, plus /web-search-config for interactive API-key setup.

Brave Search API key prompt

Features

  • Brave-backed search — 1–10 ranked results per query with title and snippet.
  • Read any URL — fetch http/https pages, strip HTML to text, or get the raw HTML with raw: true.
  • Large-page spillover — oversized responses truncate inline and spill the full body to a temp file the model can read on demand.
  • Interactive setup/web-search-config writes the key to ~/.config/rpiv-web-tools/config.json (chmod 0600); env var BRAVE_SEARCH_API_KEY also works.

Install

pi install npm:@juicesharp/rpiv-web-tools

Then restart your Pi session.

Tools

  • web_search — query the Brave Search API and return titled snippets. 1–10 results per call.
  • web_fetch — fetch an http/https URL, strip HTML to text (or return raw HTML with raw: true), truncate large responses with a temp-file spill for the full content.

Commands

  • /web-search-config — set the Brave API key interactively. Writes to ~/.config/rpiv-web-tools/config.json (chmod 0600). Pass --show to see the current (masked) key and env var status.

API key resolution

First match wins:

  1. BRAVE_SEARCH_API_KEY environment variable
  2. apiKey field in ~/.config/rpiv-web-tools/config.json

License

MIT