什么是 Web Search (duckse)？

Web Search 技能由 duckse 引擎驱动，是专为需要实时信息检索的 AI 编码智能体和开发人员设计的多功能元搜索工具。作为 Openclaw Skills 的组件，它提供了一个强大的接口，可从包括 Google、Bing、Brave 和 DuckDuckGo 在内的多个后端获取数据。它使智能体能够通过访问当前新闻、验证事实并直接从实时网络获取多媒体内容，从而超越静态训练数据的限制。

通过利用 duckse CLI，用户可以接收人类可读的文本或结构化 JSON 格式的结果，使其成为交互式研究和自动化数据管道的理想选择。它支持高级过滤选项，如时间限制、区域设置和安全搜索级别，以确保提供最相关且安全的数据。

下载入口:https://github.com/openclaw/skills/tree/main/skills/dwirx/duckse

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Web Search (duckse) 应用场景

• 执行技术文档或教程的常规网络搜索。
• 针对特定研究主题监控时事和突发新闻。
• 使用高级媒体过滤器获取特定的图像或视频资产。
• 通过多后端搜索结果验证事实或主张。
• 解析重定向后的最终目标 URL，以确保链接安全性和准确性。

1. 用户或 AI 智能体通过执行 duckse 命令后跟查询字符串来发起搜索。
2. 处理可选标志，如 --type（文本、新闻、图片、视频、书籍）和 --timelimit 以细化范围。
3. 该技能根据指定的搜索类型将请求路由到适当的后端（例如 Bing、Google 或 AnnasArchive）。
4. 引擎检索并解析结果，可选地使用 --expand-url 标志将 URL 展开为最终目的地。
5. 数据以格式化列表或 JSON 对象的形式返回，供智能体或开发人员立即使用。

Web Search (duckse) 配置指南

要将此技能集成到您的环境中，请确保已安装 duckse 实用程序。使用以下命令下载并安装它：

curl -sSL https://raw.githubusercontent.com/dwirx/duckse/main/scripts/install.sh | bash

安装后，通过运行帮助命令验证设置：

duckse --help

如果您在没有全局二进制文件的本地开发环境中工作，可以使用以下命令运行该技能：

uv run python main.py ""

Web Search (duckse) 数据架构与分类体系

此技能利用动态请求-响应模式，不维护持久性本地数据库。结果结构如下：

启用 --json 标志后，该技能输出标准 JSON 对象数组，便于 Openclaw Skills 自动化进行解析。

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 duckse (DDGS-based CLI) to return clean results in pretty text or JSON.

Web Search (duckse)

Overview

Gunakan duckse untuk metasearch web berbasis DDGS. Skill ini mendukung:

• text, news, images, videos, books
• filter waktu, region, safe search, backend
• output rapi (default) atau JSON (--json)
• URL final via redirect (--expand-url)

When to Use This Skill

Gunakan skill ini saat user meminta:

• pencarian web umum
• berita terbaru/topik tertentu
• pencarian gambar/video
• riset cepat dengan sumber URL
• fact-checking berbasis hasil web

Prerequisites

Pastikan duckse tersedia:

duckse --help

Jika belum ada, install:

curl -sSL https://raw.githubusercontent.com/dwirx/duckse/main/scripts/install.sh | bash

Core Commands

1. Basic Web Search

duckse ""

Contoh:

duckse "python asyncio tutorial"

2. Limit Results

duckse "" --max-results 

Contoh:

duckse "machine learning frameworks" --max-results 20

3. Time Filter

duckse "" --timelimit 

Contoh:

duckse "artificial intelligence news" --type news --timelimit w

4. News Search

duckse "" --type news

Contoh:

duckse "climate change" --type news --timelimit w --max-results 15

5. Image Search

duckse "" --type images

Contoh:

duckse "sunset over mountains" --type images --max-results 20

Filter image:

duckse "landscape photos" --type images --size Large
duckse "abstract art" --type images --color Blue
duckse "icons" --type images --type-image transparent
duckse "wallpapers" --type images --layout Wide

6. Video Search

duckse "" --type videos

Contoh:

duckse "python tutorial" --type videos --max-results 15

Filter video:

duckse "cooking recipes" --type videos --duration short
duckse "documentary" --type videos --resolution high

7. Books Search

duckse "" --type books --backend annasarchive

Contoh:

duckse "sea wolf jack london" --type books --max-results 10

8. Region and SafeSearch

duckse "" --region us-en --safesearch moderate

Contoh:

duckse "local news" --type news --region us-en --safesearch on

9. JSON and Final URL

JSON output:

duckse "quantum computing" --json

Resolve final URL:

duckse "beritakan di indonesia hari ini" --expand-url --max-results 5

Valid Backends by Type

• text: bing, brave, duckduckgo, google, grokipedia, mojeek, yandex, yahoo, wikipedia, auto
• images: duckduckgo, auto
• videos: duckduckgo, auto
• news: bing, duckduckgo, yahoo, auto
• books: annasarchive, auto

Common Usage Patterns

Research Topic

duckse "machine learning basics" --max-results 15
duckse "machine learning" --type news --timelimit m --max-results 15
duckse "machine learning tutorial" --type videos --max-results 10

Current Events Monitoring

duckse "climate summit" --type news --timelimit d --max-results 20

Fact-Checking

duckse "specific claim to verify" --type news --timelimit w --max-results 20 --expand-url

Quick Reference

Command format:

duckse "" [options]

Essential options:

• --type (text|images|videos|news|books)
• --max-results
• --timelimit (d|w|m|y)
• --region
• --safesearch (on|moderate|off)
• --backend
• --json
• --expand-url
• --proxy, --timeout, --verify

Best Practices

1. Gunakan query spesifik
2. Pakai --timelimit untuk informasi terbaru
3. Pakai --expand-url jika butuh URL final
4. Gunakan --json untuk otomasi/pipeline
5. Sesuaikan --max-results (mulai 10-20)

Troubleshooting

• duckse: command not found
  • tambahkan PATH: export PATH="$HOME/.local/bin:$PATH"
• backend tidak valid
  • sesuaikan dengan daftar backend per type
• hasil kosong
  • longgarkan query atau hapus filter waktu
• timeout/network
  • ulangi, tambah --timeout, atau gunakan --proxy

Development Fallback

Jika sedang develop lokal tanpa binary terpasang global:

uv run python main.py "" [opsi yang sama]