pi-mono-web-search

Pi extension for web search and page reading using DuckDuckGo and Mozilla Readability extraction.

Installation

This extension is part of the pi-extensions monorepo. It is auto-discovered when the monorepo is loaded.

Prerequisites

No external system tools are required. Search and page fetching use the Node.js runtime built into pi.

Tools

web_search

Search the web using DuckDuckGo. Returns titles, URLs, and content snippets for each result.

| Parameter | Type | Required | Default | Description | | ------------------ | -------- | -------- | ------- | -------------------------------- | | query | string | ✅ | — | Search query string | | maxResults | number | ❌ | 5 | Maximum results (1–10) | | maxResponseChars | number | ❌ | — | Truncate output before returning |

web_read

Fetch a web page and extract its readable content.

| Parameter | Type | Required | Default | Description | | ------------------ | -------- | -------- | ------- | -------------------------------------- | | url | string | ✅ | — | Page URL (http: or https: only) | | maxChars | number | ❌ | 8000 | Maximum content characters (100–50000) | | maxResponseChars | number | ❌ | — | Truncate output before returning |

Security

• web_read validates URLs before fetching. Only http: and https: are allowed.
• Private/internal network addresses (localhost, 127.0.0.1, 10.x.x.x, 172.16.x.x, 192.168.x.x, 169.254.x.x) are blocked.
• User input is never passed through a shell; the extension does not spawn subprocesses for search or page reads.

Architecture

web-search/
├── index.ts                  # Extension entrypoint
├── package.json              # Package manifest
├── src/
│   ├── web-search-schemas.ts # TypeBox parameter schemas
│   ├── web-search-tools.ts   # Tool registration
│   └── web-search-client.ts  # Business logic, fetching, and parsing
├── skills/
│   └── web-search/
│       └── SKILL.md          # LLM skill instructions
└── __tests__/
    └── web-search.test.ts    # Unit tests

Development

Run tests:

npm test

Limitations

• No JavaScript execution — SPAs may return incomplete content.
• PDFs and other binary formats are not supported.
• DuckDuckGo may rate-limit aggressive querying.

License

MIT