Web Search (duckse)

概述

使用 duckse 进行基于 DDGS 的元搜索。该技能支持：

• - text（文本）、news（新闻）、images（图片）、videos（视频）、books（书籍）
• 时间筛选、地区、安全搜索、后端
• 整洁输出（默认）或 JSON 格式（--json）
• 通过重定向获取最终 URL（--expand-url）

何时使用该技能

当用户请求以下内容时使用此技能：

• - 通用网页搜索
• 最新新闻/特定主题
• 图片/视频搜索
• 快速研究并获取来源 URL
• 基于网页结果的事实核查

前置条件

确保 duckse 可用：

bash
duckse --help

如果尚未安装，请执行：

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

核心命令

1. 基础网页搜索

bash
duckse <查询词>

示例：

bash
duckse python asyncio 教程

2. 限制结果数量

bash
duckse <查询词> --max-results

示例：

bash
duckse 机器学习框架 --max-results 20

3. 时间筛选

bash
duckse <查询词> --timelimit

示例：

bash
duckse 人工智能新闻 --type news --timelimit w

4. 新闻搜索

bash
duckse <查询词> --type news

示例：

bash
duckse 气候变化 --type news --timelimit w --max-results 15

5. 图片搜索

bash
duckse <查询词> --type images

示例：

bash
duckse 山间日落 --type images --max-results 20

图片筛选：

bash
duckse 风景照片 --type images --size Large
duckse 抽象艺术 --type images --color Blue
duckse 图标 --type images --type-image transparent
duckse 壁纸 --type images --layout Wide

6. 视频搜索

bash
duckse <查询词> --type videos

示例：

bash
duckse Python 教程 --type videos --max-results 15

视频筛选：

bash
duckse 烹饪食谱 --type videos --duration short
duckse 纪录片 --type videos --resolution high

7. 书籍搜索

bash
duckse <查询词> --type books --backend annasarchive

示例：

bash
duckse 海狼 杰克·伦敦 --type books --max-results 10

8. 地区和安全搜索

bash
duckse <查询词> --region us-en --safesearch moderate

示例：

bash
duckse 本地新闻 --type news --region us-en --safesearch on

9. JSON 和最终 URL

JSON 输出：

bash
duckse 量子计算 --json

解析最终 URL：

bash
duckse 今日印尼新闻 --expand-url --max-results 5

各类型有效后端

• - 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

常见使用模式

研究主题

bash
duckse 机器学习基础 --max-results 15
duckse 机器学习 --type news --timelimit m --max-results 15
duckse 机器学习教程 --type videos --max-results 10

时事监控

bash
duckse 气候峰会 --type news --timelimit d --max-results 20

事实核查

bash
duckse 待验证的具体声明 --type news --timelimit w --max-results 20 --expand-url

快速参考

命令格式：

bash
duckse <查询词> [选项]

基本选项：

• - --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

最佳实践

1. 1. 使用具体查询词
2. 使用 --timelimit 获取最新信息
3. 如需最终 URL 请使用 --expand-url
4. 自动化/流水线场景使用 --json
5. 适当调整 --max-results（从 10-20 开始）

故障排除

• - duckse: command not found

• - 后端无效

• - 结果为空

• - 超时/网络问题

开发备用方案

如果在本地开发且未全局安装二进制文件：

bash
uv run python main.py <查询词> [相同选项]