SearXNG-lite

轻量级多引擎聚合网页搜索工具。无需 Docker、无需服务器、也无需部署 SearXNG 实例——仅需一个 Python 脚本，即可直接向各大搜索引擎发起查询请求。

支持 9 个类别的共 26 个搜索引擎，支持并发执行，输出格式包括 JSON 和紧凑型纯文本。

本工具的独特之处

不同于其他依赖运行中 SearXNG 服务的 SearXNG 技能，本技能具有以下特性：

• 零基础设施依赖 —— 无需 Docker、无需 SearXNG 实例、无需 HTTP 服务
• 单文件设计 —— 仅一个 Python 脚本（约 850 行）完成全部功能
• 直连查询 —— 通过 httpx 在进程内直接向搜索引擎发送 HTTP 请求
• 配置热重载 —— 编辑 config.yml 即可启用/禁用类别，修改即时生效
• 并发执行 —— 最多支持 5 个线程并行查询多个搜索引擎
• 结果去重与融合 —— 合并来自不同引擎的重复结果，并基于跨引擎重合度进行打分排序

系统要求

• Python 3.10 或更高版本
• httpx —— HTTP 客户端（pip3 install httpx）
• lxml —— HTML 解析器（pip3 install lxml；macOS 系统已预装）
• （可选）socksio —— 提供 SOCKS 代理支持（pip3 install socksio）
• （可选）pyyaml —— 用于解析配置文件（pip3 install pyyaml；若未安装则回退至内置简易解析器）

快速开始

# 安装依赖
pip3 install httpx lxml

# 执行搜索
python3 scripts/search.py "你的查询词"

# 列出所有可用搜索引擎
python3 scripts/search.py --list

搜索方式

python3 scripts/search.py "query"                          # 默认模式（general + knowledge 类别）
python3 scripts/search.py "query" -c dev                   # 按类别搜索
python3 scripts/search.py "query" -c dev,academic          # 多类别组合
python3 scripts/search.py "query" -e github,arxiv          # 指定具体搜索引擎
python3 scripts/search.py "query" --all                    # 使用所有已启用的搜索引擎
python3 scripts/search.py "query" -l zh-CN                 # 返回中文结果
python3 scripts/search.py "query" -n 5                     # 限制返回结果数量
python3 scripts/search.py "query" --compact                # 输出紧凑型文本（标题 + URL + 摘要）
python3 scripts/search.py --list                           # 显示全部搜索引擎及所属类别

所有路径均相对于本技能所在目录。

命令行参数

若未指定 -e 或 -c 参数，则默认在 general 与 knowledge 类别中搜索。

配置说明

编辑技能目录下的 config.yml 文件来自定义行为：

# 为需要代理访问的搜索引擎（如 Google、YouTube、Reddit 等）设置代理
# 支持协议：http、https、socks5、socks5h
# 留空则禁用代理 —— 需代理的搜索引擎将静默失败。
proxy: "socks5h://127.0.0.1:1080"

# 类别开关配置
categories:
  general: true       # bing、brave、duckduckgo、google🌐、startpage、yahoo
  knowledge: true     # wikipedia、wikidata、wolframalpha🌐
  dev: true           # github、gitlab、stackoverflow、hackernews、reddit🌐、huggingface🌐、mdn
  academic: true      # arxiv、semantic_scholar、google_scholar🌐、crossref
  news: false         # bing_news、reuters
  video: false        # youtube🌐
  images: false       # unsplash
  social: false       # lemmy🌐
  translate: false    # lingva🌐

代理配置

部分搜索引擎（标注 🌐 的）需通过代理访问。可通过以下三种方式配置代理：

1. config.yml 文件（推荐）：设置 proxy: "your-proxy-url"
2. 环境变量：设置 HTTPS_PROXY=your-proxy-url
3. 命令行参数：每次搜索时使用 --proxy your-proxy-url

优先级顺序为：命令行参数 > config.yml > 环境变量。

若未配置任何代理，带 🌐 标记的搜索引擎将被跳过（静默失败），其余搜索引擎的结果仍会正常返回。

配置热重载

每次执行搜索时都会重新读取 config.yml 文件，无需重启脚本 —— 修改保存后立即生效。

若 config.yml 文件缺失，脚本将自动回退至默认搜索引擎集：bing、brave、duckduckgo、wikipedia。

类别与搜索引擎列表

🌐 = 需代理访问。未配置代理时，对应搜索引擎将被跳过。

输出格式

默认输出 JSON 格式：

{
  "query": "search term",
  "results": [
    {"title": "...", "url": "...", "content": "...", "engines": ["bing","brave"], "score": 2}
  ],
  "result_count": 15,
  "elapsed": 2.1,
  "engines_used": ["bing", "brave", "wikipedia"],
  "errors": []
}

--compact 参数启用后，输出人类可读的纯文本格式：编号标题、URL、摘要、来源搜索引擎标签。

score 字段表示该结果被多少个搜索引擎共同返回；数值越高，代表结果越具共识性与相关性。

典型智能体工作流示例

• 通用研究：python3 scripts/search.py "topic" -n 5
• 查找代码库：python3 scripts/search.py "image processing python" -e github
• 学术论文检索：python3 scripts/search.py "attention mechanism" -c academic -n 5
• 技术讨论检索：python3 scripts/search.py "topic" -e hackernews,reddit
• AI 模型检索：python3 scripts/search.py "text-to-speech" -e huggingface
• 开发文档检索：python3 scripts/search.py "fetch API" -e mdn,stackoverflow
• 中文搜索：python3 scripts/search.py "大语言模型" -l zh-CN -n 5
• 新闻检索：python3 scripts/search.py "AI regulation" -c news