webserp

元搜索引擎命令行工具（Metasearch CLI）—— 并行查询 Google、DuckDuckGo、Brave、Yahoo、Mojeek、Startpage 和 Presearch。使用 curl_cffi 实现浏览器伪装，结果呈现方式类浏览器，响应速度媲美 API。

何时使用 webserp

1. 你需要获取训练数据中未包含的当前/近期信息
2. 你需要验证事实或查找原始信源
3. 你需要发现 URL、文档或代码仓库
4. 用户询问的是近期事件、版本发布或新闻动态

安装

pip install webserp

无需 API 密钥，无需配置。安装后即可直接搜索。

使用方法

# 搜索全部 7 个搜索引擎（默认行为）
webserp "如何部署 Docker 容器"

# 指定搜索引擎进行搜索
webserp "Python 异步编程教程" --engines google,brave,duckduckgo

# 限制每个搜索引擎返回的结果数量
webserp "Rust 与 Go 对比" --max-results 5

# 显示各搜索引擎的成功/失败状态
webserp "测试查询" --verbose

# 设置每个搜索引擎的超时时间（单位：秒）
webserp "查询语句" --timeout 15

# 使用代理
webserp "查询语句" --proxy "socks5://127.0.0.1:1080"

选项说明

输出格式

标准输出为 JSON 格式（兼容 SearXNG）：

{
  "query": "部署问题",
  "number_of_results": 42,
  "results": [
    {
      "title": "如何修复 Docker 部署问题",
      "url": "https://example.com/docker-fix",
      "content": "常见的 Docker 部署问题及解决方案...",
      "engine": "google"
    }
  ],
  "suggestions": [],
  "unresponsive_engines": []
}

可使用 jq 或任意 JSON 解析器处理输出。results 数组中每个结果均包含 title、url、content 和 engine 字段。unresponsive_engines 列出所有请求失败的搜索引擎及其错误原因。

使用提示

• 使用 --max-results 5 可精简输出，适用于仅需少量链接的场景
• 使用 --engines google,brave 可限定特定搜索引擎，提升响应速度
• 使用 --verbose（输出至 stderr）可查看各搜索引擎响应状态 —— stdout 上的 JSON 输出不受影响
• 结果按 URL 在不同搜索引擎间自动去重，同一链接不会重复出现