@touchtechclub/pi-oc-web-tools

Pi coding-agent extension: web fetch and web search tools with MCP transport. Opencode-inspired.

Package details

extension

Install @touchtechclub/pi-oc-web-tools from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@touchtechclub/pi-oc-web-tools

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

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

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

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

# In pi-toolkit root:
bun install

Then add to .pi/settings.json:

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

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

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.

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)

Searches the web via MCP-based search providers.

MIT