web-search

Perform real-time web searches and return structured result items.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/chancoute/sgin --skill web-search-chancoute
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-search
Source: https://github.com/chancoute/sgin/tree/main/skills/web-search
Command: npx skills add https://github.com/chancoute/sgin --skill web-search-chancoute

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Applications often need to fetch current information from the web to power decision-making, research, and content discovery.

Core Features & Use Cases

  • Real-time web searching: query the open web and retrieve fresh results.
  • Structured results: each item includes url, name, snippet, host_name, rank, date, and favicon for easy consumption by downstream apps.
  • Use cases: build search features, monitor topics, conduct rapid research, and aggregate news from multiple sources.

Quick Start

Run a simple search using the backend SDK or CLI. For example, search for "artificial intelligence" using the z-ai-web-dev-sdk backend or the CLI command: z-ai function -n web_search -a '{"query":"artificial intelligence"}'. See {project_path}/skills/web-search/scripts/web_search.ts for a quick in-repo example.

Frequently Asked Questions about web-search

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

FAQPage Schema
How do I get structured real-time web search results for my backend application?

You can perform real-time web searches and retrieve structured results by integrating the z-ai-web-dev-sdk on your backend, which returns an array of objects containing url, name, snippet, host_name, rank, date, and favicon for easy application consumption.

Can I run a quick web search query from the command line?

Yes, you can execute a web search via the CLI command using the z-ai-web-dev-sdk, for example: z-ai function -n web_search -a '{"query":"artificial intelligence"}', which outputs structured search results directly in your terminal.

What specific fields are included in the structured web search results?

The structured web search results output an array of SearchFunctionResultItem objects containing the url, name, snippet, host_name, rank, date, and favicon fields to support downstream application features.

Does the web search SDK require any specific dependencies to work?

Yes, implementing live web search requires the z-ai-web-dev-sdk installed on your backend to handle the search queries and return the structured results for your application.

What are the best use cases for integrating live web search into an application?

Live web search is ideal for building search features, monitoring specific topics, conducting rapid research, and aggregating fresh news from multiple sources using structured data outputs.