🌐 Multi-Web-Search v2.0.0

免费、无需 API Key 的多引擎网页搜索。 支持 20 个搜索引擎（11 国际 + 7 国内 + 2 专业），可并行搜索、时间过滤、站点过滤。

快速开始

# 基础搜索（自动选择引擎）
python3 search.py -q "python tutorial"

# 多引擎并行
python3 search.py -q "react hooks" -e google,brave

# 时间过滤
python3 search.py -q "AI news" --time week

# 站点搜索
python3 search.py -q "machine learning" --domain github.com

# 无 ddgs 时，使用 DuckDuckGo Lite
python3 search.py -q "test" --lite

支持的搜索引擎

🌐 国际引擎

🔬 专业知识引擎

🇨🇳 国内引擎（7个）

CLI 参数

时间过滤值

高级搜索技巧

Google 搜索操作符

Brave 特色搜索

DuckDuckGo Bangs

执行步骤（CLI 使用）

根据不同搜索目标选择最佳引擎组合：

🇨🇳 国内引擎深度指南

🌐 国际引擎使用技巧

架构

~/.openclaw/skills/multi-web-search/scripts/
├── constants.py        # 16+ 引擎定义
├── url_builder.py     # URL 构建
├── cache_utils.py     # 结果缓存（TTL 1小时）
├── result_scorer.py   # 结果评分排序
├── search.py          # ✅ 唯一入口 (v3.4)
└── install.py         # 安装脚本

输出格式

{
  "provider": "multi-engine",
  "query": "python tutorial",
  "engines": ["google", "brave"],
  "search_type": "text",
  "time_filter": "week",
  "domain": null,
  "results": [
    {
      "title": "Python Tutorial",
      "url": "https://...",
      "snippet": "...",
      "source": "google",
      "_score": 85.3
    }
  ],
  "engine_results": {...},
  "total_results": 10,
  "unique_results": 8,
  "ddgs_available": true,
  "dht_enabled": false,
  "proxy": null
}

输出字段说明

实现步骤

调用此技能时，按以下步骤执行：

1️⃣ 解析用户需求

提取搜索请求中的关键参数：

引擎选择优先级：

• 用户明确指定 → 使用用户指定引擎
• 中文内容 → 默认添加国内引擎（baidu / bing_cn）
• 隐私优先 → Brave / DuckDuckGo / Startpage
• 未指定 → 使用 DEFAULT_ENGINES = ["google", "brave"]

搜索类型选择：

• 文本搜索 → text（默认）
• 图片搜索 → images（支持 size/color/type/layout/license 参数）
• 新闻搜索 → news（支持时间过滤）
• 视频搜索 → videos（支持 resolution/duration 参数）
• 书籍搜索 → books |

2️⃣ 执行搜索

# 文本搜索
python3 search.py -q "\x3Cquery>" -e \x3Cengines> [-t \x3Ctime>] [-d \x3Cdomain>] [-r \x3Cregion>]

# 图片搜索
python3 search.py -q "\x3Cquery>" --type images [-m 10] [--size Large] [--color Blue]

# 新闻搜索
python3 search.py -q "\x3Cquery>" --type news --time week

# 视频搜索
python3 search.py -q "\x3Cquery>" --type videos [--duration medium]

# 书籍搜索
python3 search.py -q "\x3Cquery>" --type books

# 代理 + 超时
python3 search.py -q "\x3Cquery>" --proxy socks5h://127.0.0.1:9150 --timeout 10

# 启用 DHT 加速
python3 search.py -q "\x3Cquery>" --dht

执行逻辑：

如果 ddgs 可用:
    → 使用 ddgs 多引擎并行搜索（支持 text/images/news/videos/books）
    → 如果启用 DHT → 自动使用 DHT 网络缓存
否则:
    → 使用 DuckDuckGo Lite URL 生成
    → 通过 web_fetch 获取结果

降级策略：

• ddgs 不可用 → 自动降级到 DuckDuckGo Lite
• 单引擎失败 → 继续返回其他引擎结果
• 引擎不支持该搜索类型 → 返回错误提示支持的引擎
• DHT 网络不可用 → 静默回退到普通缓存

3️⃣ 处理结果

多引擎结果合并：

• 所有引擎结果合并到统一列表
• 每个结果标注 source 字段（来源引擎）
• 根据 _score 字段排序（仅 text 类型）

结果格式因搜索类型而异：

• text: {title, url, snippet, source}
• images: {title, url, image, thumbnail, width, height, source}
• news: {title, url, snippet, published_date, source}
• videos: {title, url, description, duration, embed_url, thumbnail, source}
• books: {title, url, author, publisher, source}

去重逻辑：

• URL 完全相同的结果只保留一个
• 保留评分最高的那条
• 不支持的引擎返回全部结果

4️⃣ 错误处理

5️⃣ 格式化输出

结果呈现：

• 标题加粗，显示 URL 链接
• snippet 展示摘要内容
• 标注来源引擎和相关性评分
• 标注搜索类型（text/images/news/videos/books）

JSON 输出（--json）：

{
  "provider": "multi-engine",
  "query": "python tutorial",
  "engines": ["google", "brave"],
  "search_type": "text",
  "time_filter": "week",
  "domain": null,
  "results": [
    {
      "title": "Python Tutorial",
      "url": "https://...",
      "snippet": "...",
      "source": "google",
      "_score": 85.3
    }
  ],
  "engine_results": {...},
  "total_results": 10,
  "unique_results": 8,
  "ddgs_available": true,
  "dht_enabled": false,
  "proxy": null
}

输出标志含义：

• ddgs_available: true → 使用 ddgs 并行搜索，速度更快
• ddgs_available: false → 降级到 DuckDuckGo Lite
• dht_enabled: true → 使用 DHT 网络加速（重复查询提速 90%%）
• proxy: \x3Cproxy_url> → 使用代理服务器
• unique_results \x3C total_results → 有重复结果已去重

无 ddgs 时，自动降级到 DuckDuckGo Lite URL 生成，使用 web_fetch 获取结果。

安全与隐私

• 无需 API Key：所有搜索基于免费工具
• 零配置：无需注册账号
• 隐私友好引擎：支持 Brave、DuckDuckGo、Startpage 等
• 本地缓存：仅存本地，无远程传输

免费网页搜索技能，支持 16+ 引擎。