web-search

Perform real-time web searches and return structured SearchFunctionResultItem objects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Backend applications often require up-to-date information that cannot be pre-baked into the system. The web-search skill provides a reliable way to query the open web and return structured results for downstream processing.

Core Features & Use Cases

  • Real-time web search: fetch current information, articles, and research across sources.
  • CLI and SDK usage: perform quick lookups from the command line or within backend code.
  • Result handling: returns an array of structured items with url, name, snippet, host_name, date, and favicon for easy display and analytics.

Quick Start

Use the web-search skill to perform a search like "privacy-preserving computing" from the CLI or via the SDK. For example, run a CLI query or write code to invoke the web_search function with a query string and process the results.

Frequently Asked Questions about web-search

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

FAQPage Schema
How do I get real-time web search results in a backend application?

To get real-time web search results in a backend application, you can use an SDK-based query function to fetch current information and articles across multiple sources. This returns structured data for downstream processing.

Can I perform quick web search lookups from the command line?

You can perform quick web search lookups directly from the command line using the skill's built-in CLI utility. This allows you to easily query topics and discover content without writing backend code.

What format do real-time web search results return for downstream processing?

Real-time web search results return an array of structured items containing url, name, snippet, host_name, date, and favicon fields. This structured format enables easy display and analytics in your application.

Do I need a specific SDK to integrate real-time web search into my app?

Yes, you need the z-ai-web-dev-sdk installed in your backend environment to integrate real-time web search. This dependency enables the core search function and returns structured result items.

What is the best way to fetch current news and articles across multiple sources?

The best way to fetch current news and articles across multiple sources is to use an SDK-based query function. This approach provides structured results with snippets and metadata for reliable content discovery.

Are there limitations when using SDK integration for real-time web searches?

When using SDK integration for real-time web searches, results depend on the availability of current information across queried sources. The skill provides utilities for formatting and filtering to manage the returned structured items.