pi-web-toolkit

Web research toolkit for the pi coding agent. Search via SearXNG, fetch static pages with scrapling, browse interactively via agent-browser, and batch-read sources in parallel.

Packages

Package details

extension

Install pi-web-toolkit from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-web-toolkit
Package
pi-web-toolkit
Version
0.1.1
Published
Jun 4, 2026
Downloads
not available
Author
wade11s
License
MIT
Types
extension
Size
46.7 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts"
  ]
}

Security note

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

README

pi-web-toolkit

Web research toolkit for pi agents. Search, fetch, browse, and batch-read the web.

Features

Tool Purpose
web_search Search the web via SearXNG
web_fetch Fetch a single static page as clean markdown
web_browse Interact with a page (click, scroll, fill) then extract content
web_batch_fetch Fetch 2–10 pages in parallel for research synthesis

Installation

Option 1: From npm (recommended)

pi install pi-web-toolkit

Option 2: From GitHub

pi install git:github.com/Wade11s/pi-web-toolkit

Requirements

  • Node.js ≥ 20 — for running pi extensions
  • SearXNG — for web_search
    # Set your SearXNG instance URL (default: http://localhost:8080)
    export SEARXNG_URL="http://localhost:8080"
    
    # Self-host with Docker
    docker run -d -p 8080:8080 -v searxng:/etc/searxng searxng/searxng
    
  • scrapling — for web_fetch and web_batch_fetch
    # recommended: install scrapling via uv
    uv tool install "scrapling[all]"
    scrapling install
    
  • agent-browser — for web_browse
    npm i -g agent-browser && agent-browser install
    
    Verify installation:
    agent-browser doctor
    

Project Structure

pi-web-toolkit/
├── extensions/
│   ├── utils/
│   │   └── scrapling.ts    # scrapling CLI wrapper
│   ├── web_search.ts       # web_search
│   ├── web_fetch.ts        # web_fetch
│   ├── web_browse.ts       # web_browse (agent-browser)
│   └── web_batch_fetch.ts  # web_batch_fetch
├── docs/
│   ├── tools.md
│   └── guide.md
├── package.json
├── README.md
└── LICENSE

Reference

  • Tool Reference — Full parameter specs and usage examples for each tool.
  • Usage Guide — Decision tree and tool comparison.

License

MIT