@touchtechclub/pi-oc-web-tools

Opencode-inspired Pi extension providing web fetch and web search tools with MCP transport.

Features

• webfetch — Fetch and convert web page content to markdown, plain text, or raw HTML
• websearch — Search the web using MCP-based providers (Exa, Parallel)
• MCP JSON-RPC transport — Low-level SSE/JSON response parsing for search providers
• Turndown integration — HTML to Markdown conversion for readable output
• Redirect handling — Automatic retry on Cloudflare bot-detection challenges

Install

Local linking (development)

# In pi-toolkit root:
bun install

Then add to .pi/settings.json:

{
  "packages": ["../packages/oc-web-tools"]
}

From npm

pi extension add @touchtechclub/pi-oc-web-tools

Configuration

Variable	Description
EXA_API_KEY	Exa search API key (appended to MCP URL)
PARALLEL_API_KEY	Parallel search API key (Bearer auth)
OC_WEBSEARCH_PROVIDER	Override provider: exa or parallel

If neither API key is set, Exa's public tier is used as fallback.

Tools

webfetch

Fetches a URL and returns content in the specified format.

Parameter	Type	Description
url	string	URL to fetch (must start with http:// or https://)
format	"markdown" | "text" | "html"	Output format (default: markdown)
timeout	number?	Timeout in seconds (max 120, default 30)

websearch

Searches the web via MCP-based search providers.

Parameter	Type	Description
query	string	Search query
numResults	number?	Results to return (default: 8)
livecrawl	"fallback" | "preferred"?	Live crawl mode
type	"auto" | "fast" | "deep"?	Search type
contextMaxCharacters	number?	Max chars for context string

License

MIT