@capotej/pi-zsearch

Adds web_search and web_read tools powered by the Z.AI API.

Packages

Package details

extension

Install @capotej/pi-zsearch from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@capotej/pi-zsearch
Package
@capotej/pi-zsearch
Version
1.0.0
Published
Jun 7, 2026
Downloads
80/mo · 80/wk
Author
capotej
License
MIT
Types
extension
Size
13.5 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

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

README

@capotej/pi-zsearch

A pi extension that adds web search and web page reading capabilities via the Z.AI API.

Tools

web_search

Search the web using the Z.AI Web Search API. Returns structured results with titles, summaries, URLs, source names, and publication dates.

Parameter Type Required Default Description
query string ✅ — The search query
count number ❌ 10 Number of results (1–50)
domain string ❌ — Limit to a specific domain (e.g. github.com)
recency enum ❌ noLimit Time filter: oneDay, oneWeek, oneMonth, oneYear, noLimit

web_read

Read and parse a web page using the Z.AI Web Reader API. Returns page content as markdown or plain text.

Parameter Type Required Default Description
url string ✅ — The URL to read
return_format enum ❌ markdown Output format: markdown or text
no_cache boolean ❌ false Disable caching
retain_images boolean ❌ true Keep images in output
with_images_summary boolean ❌ false Include image summary
with_links_summary boolean ❌ false Include links summary
timeout number ❌ 20 Request timeout in seconds

Installation

pi install npm:@capotej/pi-zsearch

Setup

Set the ZAI_API_KEY environment variable. Get your API key at z.ai/manage-apikey.

export ZAI_API_KEY="your-api-key"

Development

npm install
npm run build

License

MIT