# Web Search

> Search the web and read page content using native pi tools — DuckDuckGo search results, web page fetching, and Mozilla Readability extraction. No external system tools required. Use when this capability is needed.

- Skill: `tomevault-io/web-search-21` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/web-search-21`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/web-search-21/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/web-search-21

---


# Web Search

Search the web and read page content using DuckDuckGo and Mozilla Readability extraction.

## 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.

**When to use:**

- The user asks to find information online
- Looking up documentation not available locally
- Verifying facts or looking up recent data

**Parameters:**

- `query` (string, required): Search query
- `maxResults` (number, optional, default 5, max 10): How many results to return
- `maxResponseChars` (number, optional): Truncate output to this many characters

**Guidelines:**

- Always follow up with `web_read` if the user needs full page content
- DuckDuckGo is used — no API key required
- Rate limits apply; avoid rapid repeated queries

### `web_read`

Fetch a web page and extract readable content.

**When to use:**

- You need the full content of a specific page
- Following up on a `web_search` result
- Reading documentation or articles

**Parameters:**

- `url` (string, required): Page URL (must be `http:` or `https:`)
- `maxChars` (number, optional, default 8000, max 50000): How many characters of content to return
- `maxResponseChars` (number, optional): Truncate output to this many characters

**Guidelines:**

- Works best on article/blog pages
- JavaScript-heavy SPAs may return limited content (no JS execution)
- Private/internal URLs (`localhost`, `127.0.0.1`, `169.254.x.x`, etc.) are blocked for security

## Limitations

- **No JavaScript rendering:** Pages that require JS to load content will return incomplete results.
- **HTML only:** PDFs or other binary formats are not supported.
- **DuckDuckGo rate limiting:** Aggressive querying may be throttled.

---
> Source: [emanuelcasco/pi-mono-extensions](https://github.com/emanuelcasco/pi-mono-extensions) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-24 -->

