Multi-Web-Search | 多引擎网页搜索

提供无须API密钥的多引擎并行网页搜索，支持20个国际、国内及专业搜索引擎，含时间和站点过滤，支持图片、新闻、视频搜索及DHT加速。

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install multi-web-search

🌐 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

支持的搜索引擎

🌐 国际引擎

引擎	说明	适用场景	隐私
`google`	Google 搜索	综合搜索、技术文档、学术资源	❌
`google_hk`	谷歌香港	简化版 Google，广告少	❌
`brave`	Brave Search	隐私优先、新闻聚合、Discussions	✅
`ddg` / `duckduckgo`	DuckDuckGo	隐私搜索、Bangs 快捷跳转	✅
`bing`	Microsoft Bing	微软生态、英文搜索	❌
`yahoo`	Yahoo Search	新闻聚合、传统搜索用户	❌
`startpage`	Startpage	Google 结果 + 隐私保护	✅
`ecosia`	Ecosia（环保）	环保搜索、植树公益	✅
`qwant`	Qwant（欧盟）	欧盟推荐、不追踪用户	✅
`yandex`	Yandex（俄罗斯）	俄语搜索、俄罗斯资源	❌
`mojeek`	Mojeek（独立索引）	自有索引、隐私友好	✅

🔬 专业知识引擎

引擎	说明	适用场景
`wikipedia`	维基百科	概念、术语、历史人物等百科查询
`wolframalpha`	计算知识引擎	数学公式、统计数据、单位换算
`github`	GitHub 代码搜索	代码片段、开源项目、Issue 查询
`stackoverflow`	Stack Overflow	编程问题、技术方案、错误排查

🇨🇳 国内引擎（7个）

引擎	说明	适用场景
`baidu`	百度搜索	中文内容、百度系产品
`bing_cn`	必应中国版	中文结果（ensearch=0）
`bing_int`	必应国际版	英文结果（ensearch=1）
`360`	360搜索	安全搜索、网址导航
`sogou`	搜狗搜索	知乎/微信公众号
`wechat`	微信搜索	公众号文章
`shenma`	神马搜索	移动端内容、UC浏览器

CLI 参数

参数	说明	示例
`-q, --query`	搜索查询	`-q "python tutorial"`
`-e, --engines`	引擎列表（逗号分隔）	`-e google,brave,baidu`
`-m, --max-results`	每引擎最大结果数	`-m 10`
`-t, --time`	时间过滤	`--time week`
`-d, --domain`	站点搜索	`--domain github.com`
`-r, --region`	地区代码	`-r us-en`
`--lite`	强制 DuckDuckGo Lite	`--lite`
`--no-cache`	禁用缓存	`--no-cache`
`--no-rank`	禁用评分排序	`--no-rank`
`-o, --output`	输出文件	`-o results.json`
`--json`	紧凑 JSON 输出	`--json`
`--proxy, -pr`	代理服务器	`--proxy socks5h://127.0.0.1:9150`
`--type`	搜索类型	`--type text` (默认) / `images` / `news` / `videos` / `books`
`--timeout`	单引擎超时秒数	`--timeout 10` (默认 30)
`--dht`	启用 DHT 网络加速	`--dht`

时间过滤值

值	含义	Google 参数	Brave 参数
`hour`	最近 1 小时	`qdr:h`	`ph`
`day`	最近 24 小时	`qdr:d`	`pd`
`week`	最近 7 天	`qdr:w`	`pw`
`month`	最近 30 天	`qdr:m`	`pm`
`year`	最近 365 天	`qdr:y`	`py`

高级搜索技巧

Google 搜索操作符

操作符	功能	示例
`" "`	精确匹配	`"machine learning"`
`-`	排除关键词	`python -snake`
`OR`	或运算	`machine OR deep learning`
`site:`	站内搜索	`site:github.com python`
`filetype:`	文件类型	`filetype:pdf annual report`
`intitle:`	标题包含	`intitle:tutorial python`
`inurl:`	URL 包含	`inurl:login admin`

Brave 特色搜索

功能	说明	参数
`Goggles`	自定义搜索规则	创建个性化过滤器
`Discussions`	论坛讨论聚合	搜索 Reddit 等论坛
`source=news`	新闻搜索	独立新闻索引
`source=images`	图片搜索	图片索引

DuckDuckGo Bangs

Bang	跳转	示例
`!g`	Google 搜索	`!g python`
`!gh`	GitHub	`!gh tensorflow`
`!so`	Stack Overflow	`!so javascript`
`!w`	Wikipedia	`!w AI`
`!yt`	YouTube	`!yt tutorial`

执行步骤（CLI 使用）

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

搜索目标	首选引擎	原因
综合中文内容	百度	中文索引最全
公众号文章	搜狗 + 微信	唯一支持公众号搜索
知乎内容	搜狗	知乎优化好
隐私优先	Brave / DuckDuckGo / Startpage	不追踪用户
技术文档 / 编程	Google + Stack Overflow	技术文档全面
GitHub 代码搜索	GitHub 专用引擎	代码片段/开源项目最准
实时新闻	Brave News / Bing	新闻聚合能力强
编程问题排查	Stack Overflow / Google	错误方案最全
学术资源	Google + 百度学术	论文、学术搜索
俄语 / 俄罗斯资源	Yandex	俄语区比 Google 更准
环保公益搜索	Ecosia	搜索即植树
计算型查询	WolframAlpha	数学/统计/单位换算
百科知识	Wikipedia	概念、术语、历史人物
图片搜索	`ddgs images()` / Brave	图片索引聚合
视频搜索	`ddgs videos()`	视频结果聚合
新闻搜索	`ddgs news()`	新闻聚合（支持时间过滤）

🇨🇳 国内引擎深度指南

引擎	特色功能	搜索示例
百度	中文索引最全、百度学术、百度新闻	`site:github.com python` / `filetype:pdf`
搜狗	知乎优化、微信公众号	`site:zhihu.com 机器学习`
微信搜索	唯一公众号文章搜索渠道	`https://wx.sogou.com/weixin?type=2&query=Python`
必应中国版	中英文结果切换（ensearch=0/1）	`https://cn.bing.com/search?q=AI&ensearch=0`
360搜索	安全搜索、网址导航	安全过滤默认开启
神马搜索	移动端优化、UC浏览器集成	`https://m.sm.cn/s?q=关键词`

🌐 国际引擎使用技巧

引擎	特色技巧	示例
Brave	Discussions（论坛聚合）、News、图片搜索	`source=news` / `Goggles 自定义规则`
DuckDuckGo	Bangs 快捷跳转（!g / !gh / !so）	`!so python error` → 直接跳转 Stack Overflow
Startpage	Anonymous View 匿名浏览、Google 结果	不调用 Google 但显示相同结果
Ecosia	每约 45 次搜索种一棵树	环保主义者首选
Qwant	欧盟官方推荐、不做个性化追踪	适合注重数据主权用户
Yandex	俄语搜索、俄区内容	俄语学习、俄罗斯文化资源
Mojeek	自有独立索引，不依赖 Google/Bing	隐私激进用户的替代方案

架构

~/.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
}

输出字段说明

字段	类型	说明
`search_type`	string	搜索类型：text/images/news/videos/books
`dht_enabled`	bool	是否启用 DHT 网络加速
`proxy`	string/null	代理服务器地址
`engine_results`	dict	各引擎的详细结果（包含 success/error/url）

实现步骤

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

1️⃣ 解析用户需求

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

参数	来源	示例
查询内容	用户输入	`"python tutorial"`
引擎选择	`-e` 参数或推断	`google,brave`
时间过滤	`--time` 参数	`week`、`month`
站点限制	`--domain` 参数	`github.com`
地区代码	`-r` 参数	`cn-zh`、`us-en`
搜索类型	`--type` 参数	`text`、`images`、`news`、`videos`、`books`
代理	`--proxy/-pr` 参数	`socks5h://127.0.0.1:9150`
超时	`--timeout` 参数	`10`（秒）
DHT 加速	`--dht` 参数	启用 P2P 缓存加速

引擎选择优先级：

用户明确指定 → 使用用户指定引擎
中文内容 → 默认添加国内引擎（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 "<query>" -e <engines> [-t <time>] [-d <domain>] [-r <region>]

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

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

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

# 书籍搜索
python3 search.py -q "<query>" --type books

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

# 启用 DHT 加速
python3 search.py -q "<query>" --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️⃣ 错误处理

错误场景	处理方式
`ddgs` 未安装	降级到 DuckDuckGo Lite，无警告
引擎不支持时间过滤	静默忽略，仅返回其他引擎结果
引擎不支持该搜索类型	返回错误，提示支持的引擎列表
网络超时	返回已获取的结果，不阻塞
结果为空	建议换用其他引擎或重新表述
URL 编码错误	使用 `urllib.parse.quote()` 正确编码
DHT 网络不可用	静默回退到普通缓存
代理连接失败	返回错误，提示检查代理配置

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: <proxy_url> → 使用代理服务器
unique_results < total_results → 有重复结果已去重

依赖	状态	说明
python3	必须	运行环境
ddgs	推荐	多引擎并行（pip install ddgs）
ddgs[dht]	可选	DHT 网络加速（pip install ddgs[dht]）

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

安全与隐私

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

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