pi-smart-web-search

Batch web search for the Pi coding agent — ranked, readable results ready to fetch. Pairs with pi-smart-fetch.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-smart-web-search
Package
pi-smart-web-search
Version
0.1.0
Published
Jun 20, 2026
Downloads
not available
Author
joematthewsdev
License
MIT
Types
extension
Size
26.3 KB
Dependencies
3 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/joematthews/pi-smart-web-search/main/demo.png"
}

Security note

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

README

pi-smart-web-search

A pi extension that adds one tool — web_search — for batch web discovery.

web_search in pi — search, fetch, answer

It takes an array of queries (batch-only, like batch_web_fetch), turns each into a search URL, and runs it through the same fetch→extract pipeline as pi-smart-fetch (wreq-js → linkedom → Defuddle). It returns the extracted search-results pages (titles, links, snippets as markdown), prefaced with a # Next step header telling the model to open the best result URLs.

So the model curates which links to open (no SEO-trash auto-pulled into context), and the follow-up nudge sits right next to the links.

Install

pi install npm:pi-smart-web-search
pi install npm:pi-smart-fetch   # companion (see below)

Then restart pi.

Pairs with pi-smart-fetch

web_search finds sources; it hands off to batch_web_fetch (from pi-smart-fetch) to read the chosen pages. Install it alongside, or the model has nothing to follow up with.

Usage

Once installed, start up pi and just ask a question — web_search kicks in automatically when an answer needs current or external info. Try:

What's the latest version of Node.js, and what's new in it?

Compare Bun and Deno for a new TypeScript API in 2026.

pi searches, opens the best results, and answers from what it read. No flags, no setup — just ask.

Tool

web_search(searches: string[])

Pass several queries at once to cover a topic from multiple angles in one call.

Notes

  • Search engine must be no-JS / server-rendered to extract well. The default endpoint renders without JavaScript; google.com and other JS-heavy SERPs extract poorly (the pipeline does not run JavaScript).
  • Built on the same primitives as pi-smart-fetch (wreq-js browser-grade TLS, Defuddle extraction); it does not import pi-smart-fetch's code (factory-only export), only the shared libs.

Development

Run from a local clone instead of the registry:

git clone https://github.com/joematthews/pi-smart-web-search
cd pi-smart-web-search
npm install
pi install .

Then restart pi.

npm run check runs typecheck, lint, format, spell, and tests. npx tsx debug.ts "your query" prints what the model would receive for a search.

Credits

Heavily inspired by pi-smart-fetch by Thinkscape (MIT). It shares the same pipeline (wreq-js → linkedom → Defuddle), and the web_search result card mirrors batch_web_fetch's look. Thanks to that project for the pattern.

License

MIT © Joe Matthews