web-search
Implement web search capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to search for real-time information from the web, retrieve up-to-date content beyond the knowledge cutoff, or find the latest news and data. Returns structured search results with URLs, snippets, and metadata.
npx skills add jjyaoao/HelloAgents --skill web-search --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Web Search Skill This skill guides the implementation of web search functionality using the z-ai-web-dev-sdk package, enabling applications to search the web and retrieve current information. ## Installation Path **Recommended Location**: `{project_path}/skills/web-search` Extract this skill package to the above path in your project. **Reference Scripts**: Example test scripts are available in the `{project_path}/skills/web-search/scripts/` directory for quick testing and reference. See `{project_path}/skills/web-search/scripts/web_search.ts` for a working example. ## Overview The Web Search skill allows you to build applications that can search the internet, retrieve current information, and access real-time data from web sources. **IMPORTANT**: z-ai-web-dev-sdk MUST be used in backend code only. Never use it in client-side code. ## Prerequisites The z-ai-web-dev-sdk package is already installed. Import it as shown in the examples below. ## CLI Usage (For Simple Tasks) For simple web search queries, you can use the z-ai CLI instead of writing code. This is ideal for quick information retrieval, testing search functionality, or command-line automation. ### Basic Web Search ```bas
- Installation Path
- Overview
- Prerequisites
- CLI Usage (For Simple Tasks)
- Basic Web Search
- Search with Custom Parameters
- Save Search Results
- Advanced Search Examples
- CLI Parameters
- Search Result Structure
- When to Use CLI vs SDK
- Search Result Type
- Simple Search Query
- Search with Custom Result Count
Simple search query
z-ai function --name "web_search" --args '{"query": "artificial intelligence"}'
Using short options
z-ai function -n web_search -a '{"query": "latest tech news"}'
Limit number of results
z-ai function \
Search with recency filter (results from last N days)
Save results to JSON file
Recent news with file output
Search for specific topicsWhat does the web-search skill do?
Implement web search capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to search for real-time information from the web, retrieve up-to-date content beyond the knowledge cutoff, or find the latest news and data. Returns structured search results with URLs, snippets, and metadata.
How do I install it?
Run `npx skills add jjyaoao/HelloAgents --skill web-search --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jjyaoao/HelloAgents, a repository with 2,615 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.