web-search

name	web-search
description	This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
description_zh	当用户需要在网上搜索信息、查找最新内容、查阅新闻文章、搜索图片或查找视频时使用。它使用DuckDuckGo的搜索API，以清晰、格式化的输出（文本、markdown或JSON）返回结果。适用于研究、事实核查、查找近期信息或收集网络资源。
homepage	https://clawhub.ai/billyutw/web-search
provenance	{"origin":"clawhub-mit0","license":"MIT-0","upstream_url":"https://clawhub.ai/billyutw/web-search","maintained_by":"OpenSquilla"}
metadata	{"opensquilla":{"risk":"medium","capabilities":["network-read"]}}
entrypoint	{"command":"python {baseDir}/scripts/search.py","args":["{{ with.query | default(inputs.user_message) }}","--type","{{ with.type | default('web') }}","--max-results","{{ with.max_results | default('10') }}","--format","{{ with.format | default('text') }}"],"parse":"text","timeout":45}

Web Search

Overview

Search the web using DuckDuckGo's API to find information across web pages, news articles, images, and videos. Returns results in multiple formats (text, markdown, JSON) with filtering options for time range, region, and safe search.

When to Use This Skill

Use this skill when users request:

• Web searches for information or resources
• Finding current or recent information online
• Looking up news articles about specific topics
• Searching for images by description or topic
• Finding videos on specific subjects
• Research requiring current web data
• Fact-checking or verification using web sources
• Gathering URLs and resources on a topic

Prerequisites

OpenSquilla declares the required duckduckgo-search Python package as a runtime dependency. For source checkouts, run the normal project dependency sync before invoking this bundled skill. The library provides a simple Python interface to DuckDuckGo's search API without requiring API keys or authentication.

Core Capabilities

1. Basic Web Search

Search for web pages and information:

python {baseDir}/scripts/search.py "<query>"

Example:

python {baseDir}/scripts/search.py "python asyncio tutorial"

Returns the top 10 web results with titles, URLs, and descriptions in a clean text format.

2. Limiting Results

Control the number of results returned:

python {baseDir}/scripts/search.py "<query>" --max-results <N>

Example:

python {baseDir}/scripts/search.py "machine learning frameworks" --max-results 20

Useful for:

• Getting more comprehensive results (increase limit)
• Quick lookups with fewer results (decrease limit)
• Balancing detail vs. processing time

3. Time Range Filtering

Filter results by recency:

python {baseDir}/scripts/search.py "<query>" --time-range <d|w|m|y>

Time range options:

• d - Past day