duckse（duckse 命令行）

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 "<query>"

Contoh:

duckse "python asyncio tutorial"

2. Limit Results

duckse "<query>" --max-results <N>

Contoh:

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

3. Time Filter

duckse "<query>" --timelimit <d|w|m|y>

Contoh:

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

4. News Search

duckse "<query>" --type news

Contoh:

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

5. Image Search

duckse "<query>" --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 "<query>" --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 "<query>" --type books --backend annasarchive

Contoh:

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

8. Region and SafeSearch

duckse "<query>" --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 "<query>" [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 "<query>" [opsi yang sama]