su-web-tools — Web Search & Content Tools for Pi

Web research tools for the Pi coding agent. Adds two tools — web_search and web_get — powered by the Exa API for real-time web search and content extraction.

Install

pi install /path/to/su-web-tools

After install, run /reload in Pi.

Requires EXA_API_KEY environment variable. Get one at dashboard.exa.ai/api-keys.

Tools

web_search

Search the web with Exa. Returns key highlights or full text from each result.

web_search({
  query: "natural language query",
  contentMode?: "highlights" | "text",        // default: "highlights"
  numResults?: number,                        // 1-20, default: 5
  category?: "company" | "people" | "research paper" | "news" | "personal site" | "financial report",
  type?: "auto" | "fast" | "instant" | "deep-lite" | "deep" | "deep-reasoning",  // default: "auto"
})

web_get

Extract content from specific URLs. Supports highlights, full text, and summary modes with subpage crawling for docs sites.

web_get({
  urls: ["https://..."],                      // 1-25 URLs
  contentMode?: "highlights" | "text" | "summary",  // default: "highlights"
  query?: string,                             // focus extraction on this topic
  subpages?: number,                          // crawl up to N subpages (max 10)
  subpageTarget?: string[],                   // keywords to prioritize subpages
  freshness?: "cached" | "live",             // omit for default (cached with livecrawl fallback)
})

Usage

Both tools render cleanly in the TUI — collapsed shows a summary line, expanded shows highlights/previews with cost reporting.

Configuration

Set EXA_API_KEY in your environment:

export EXA_API_KEY="your-key-here"

If the key is missing, pi shows a warning on startup but does not crash.

License

MIT