web-search

Retrieve structured web search results with URL, title, snippet, and date.

1|Updated Aug 3, 2025
One-click install
npx skills add https://github.com/eesha000009-dev/Exam-Prep100 --skill web-search-eesha000009-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-search
Source: https://github.com/eesha000009-dev/Exam-Prep100/tree/main/skills/web-search
Command: npx skills add https://github.com/eesha000009-dev/Exam-Prep100 --skill web-search-eesha000009-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires z-ai-web-dev-sdk, and includes scripts (resource) components.

What problem does it solve?

This Skill provides programmatic access to up-to-date web information so applications and scripts can avoid stale knowledge, eliminate manual browsing, and quickly gather current news, data, and page metadata for downstream analysis.

Core Features & Use Cases

  • Real-time search: Execute live web queries via the z-ai-web-dev-sdk or the z-ai CLI for immediate results.
  • Structured results: Returns results with URL, title, snippet, host_name, rank, date, and favicon for easy processing and display.
  • Integration-ready: Examples and patterns for Express APIs, summarization with chat completions, caching, rate limiting, and result validation are provided to support common production needs.
  • Use case: Build a news aggregator, research assistant, or content discovery pipeline that requires current information and source metadata.

Quick Start

Use the web-search skill to retrieve the top 5 most recent results for "artificial intelligence" and return them as JSON.

Frequently Asked Questions about web-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve real-time web search results in a server-side application?

You retrieve real-time web search results by executing live queries via the z-ai-web-dev-sdk in server-side environments, which returns structured JSON items containing URL, title, snippet, host metadata, rank, and date for immediate processing.

What is the best way to build a news aggregator pipeline that needs current information?

Building a news aggregator is best achieved by using programmatic web search capabilities to fetch current information and source metadata, returning structured items with date and rank that support recency filtering for time-sensitive queries.

Does the z-ai-web-dev-sdk support returning structured metadata like URL, title, and snippet?

Yes, the z-ai-web-dev-sdk supports returning structured search results that include URL, title, snippet, host_name, rank, date, and favicon, making the output integration-ready for downstream APIs and content discovery.

Can I use web search queries from a CLI for research and content discovery?

You can execute live web queries directly via the z-ai CLI for research and content discovery, retrieving current information and structured search results instantly without manual browsing.

What are the limitations of using SDK-based web search for production applications?

While the SDK provides structured items and recency filtering, production applications require implementing their own caching, rate limiting, and result validation patterns to manage query volume and ensure downstream stability.

How do I integrate live web search into an Express API with result validation?

You integrate live web search into an Express API by calling the z-ai-web-dev-sdk within your endpoints, using the provided integration patterns for result validation, caching, and rate limiting to return structured JSON items to clients.