Install
$ agentstack add skill-shaftoe-pi-shared-zai-web-search ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Z.ai Web Search & Reader
Provides web search and web page content extraction through z.ai's remote MCP servers. Uses the API key from ~/.pi/agent/auth.json (zai entry).
> Note: Requires an active z.ai Coding Plan subscription with available monthly quota. Search and reader share the same quota.
Search the Web
./scripts/search.sh "search query"
Parameters (positional):
query(required) — Search text, max ~70 characters recommendedlocation—us(default, non-Chinese region) orcn(Chinese region)content_size—medium(default, 400-600 words per result) orhigh(2500 words, higher cost)recency_filter—noLimit(default),oneDay,oneWeek,oneMonth,oneYeardomain_filter— Limit to a specific domain, e.g.docs.python.org
Examples:
# Basic search
./scripts/search.sh "latest TypeScript 5.8 features"
# Recent news (last week), with longer summaries
./scripts/search.sh "React 19 release notes" us high oneWeek
# Domain-scoped search
./scripts/search.sh "Array.prototype.at" us medium noLimit developer.mozilla.org
Output: JSON array of results with title, URL, summary, site name, and icon. Returns [] if quota is exhausted or no results found.
Read a Web Page
./scripts/reader.sh "https://example.com"
Parameters (positional):
url(required) — URL to fetch and readformat—markdown(default) ortextretain_images—true(default) orfalsetimeout— Seconds, default20
Examples:
# Read page as markdown
./scripts/reader.sh "https://docs.python.org/3/whatsnew/3.12.html"
# Plain text, no images
./scripts/reader.sh "https://example.com" text false
Output: Page content converted to the requested format (markdown/text).
Troubleshooting
- Empty results (
[]) — Likely monthly quota exhausted. Check your z.ai Coding Plan dashboard. - Auth error — Verify the
zaikey in~/.pi/agent/auth.jsonis valid and not expired. - Override auth file — Set
ZAI_AUTH_FILEenv var to point to a different auth file.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: shaftoe
- Source: shaftoe/pi-shared
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.