@yandy0725/pi-web-tools

pi package providing websearch and webfetch tools

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@yandy0725/pi-web-tools
Package
@yandy0725/pi-web-tools
Version
0.6.1
Published
Jun 28, 2026
Downloads
1,163/mo · 274/wk
Author
yandy0725
License
MIT
Types
extension
Size
25.1 KB
Dependencies
2 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-web-tools

A pi package providing web search and web fetch tools for coding agents.

Tools

Tool Description Source
websearch Pure web search, returns raw results (titles, URLs, snippets) Exa → Aliyun fallback
webfetch Fetch and convert web pages to text, markdown, or raw HTML —

Quick Start

# Install from npm
pi install npm:@yandy0725/pi-web-tools

# Or install from a local checkout
pi install ./path/to/pi-web-tools

# Or run directly
npm install
pi -e ./index.ts

Prerequisites

  • websearch: No config needed — Exa MCP free tier (150 calls/day). Set EXA_API_KEY for higher limits. Optional: set ALIYUN_API_KEY or configure an aliyun provider in pi for Bailian WebSearch fallback (better Chinese search results).

Configuration

Configuration uses environment variables for API keys.

API Keys (environment variables only)

Variable Description Default
EXA_API_KEY Exa API key. If not set, uses MCP free tier (150 calls/day) —
ALIYUN_API_KEY Aliyun Bailian API key for websearch fallback. Also available via pi's aliyun provider config —

Tools Reference

websearch

Search the web with automatic source fallback.

Parameters:

Parameter Type Required Default Description
query string yes — Search query
numResults number no 10 Number of results (1-20)
source "exa" | "aliyun" no — Search source

Sources:

  • Exa (default) — AI-native search API. With EXA_API_KEY: full REST API. Without: MCP free tier (150 calls/day, 3 QPS). Always available, no key needed for basic usage.
  • Aliyun (fallback) — Bailian WebSearch MCP. Requires ALIYUN_API_KEY env var or a registered aliyun provider in pi's models.json. Better for Chinese-language queries. When Exa fails, the tool automatically falls back to Aliyun.

webfetch

Fetch content from a URL and return as text, markdown, or raw HTML.

Parameters:

Parameter Type Required Default Description
url string yes — URL to fetch
format "text" | "markdown" | "html" no "markdown" Output format
timeout number no 30 Timeout in seconds (1-120)

Development

# From repo root:
npm ci                    # Install all dependencies
npm run typecheck         # Type-check all packages
npm run check             # Lint + format check
npm test                  # Run all tests

# Package-specific:
pi -e ./index.ts          # Run the extension locally (from this dir)

License

MIT