logo
0
0
WeChat Login
feat: 添加 SoSearch 搜索 API 安装与配置文档

SoSearch

一个基于 Rust 的快速网页搜索 API,聚合 DuckDuckGo、Yahoo 和 Brave Search 的搜索结果,提供 SearXNG 兼容的接口。

仓库地址

https://github.com/netlops/SoSearch

功能特性

  • 多源搜索:整合 DuckDuckGo、Yahoo 和 Brave Search 的结果
  • 无需 API Key:完全免费使用
  • SearXNG 兼容:可作为 SearXNG 实例的直接替代品
  • 跨平台支持:提供 Linux amd64 二进制文件

前置条件

  • Linux amd64 系统
  • 需要 root/sudo 权限进行安装(安装到 /usr/local/bin
  • 可选:如需防火墙代理,需配置 HTTP 代理

安装

bash <skill_dir>/scripts/install.sh

安装程序将执行以下操作:

  1. 下载最新的 Linux amd64 二进制文件到 /usr/local/bin/SoSearch
  2. 创建启动脚本 /usr/local/bin/sosearch-start.sh
  3. 在端口 3000 上启动 SoSearch,并启用代理支持

使用方法

启动 SoSearch

nohup /usr/local/bin/sosearch-start.sh > /tmp/sosearch.log 2>&1 &

测试安装

curl -s http://127.0.0.1:3000/search?q=test

正常情况下会返回 JSON 格式的搜索结果。

配置 OpenClaw

安装完成后,启用 OpenClaw 中的 SearXNG 插件:

openclaw config set plugins.entries.searxng.enabled true
openclaw config set plugins.entries.searxng.config.webSearch.baseUrl "http://127.0.0.1:3000"

然后重启网关,web_search 工具将使用 SoSearch 作为后端。

配置说明

端口配置

请使用端口 3000,不要使用 10080。Node.js 的 undici/fetch 会阻止某些"不良端口"如 10080。

代理设置

如需在防火墙后运行,请在启动 SoSearch 前设置代理环境变量:

export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

故障排除

"fetch failed" 错误

  1. 检查 SoSearch 是否正在运行:

    pgrep -f SoSearch
    
  2. 确认端口为 3000(不是 10080)

  3. 检查代理连接:

    curl -s -x http://127.0.0.1:7897 https://httpbin.org/ip
    

返回空结果

重启 SoSearch 以清除失效的连接:

pkill SoSearch
nohup /usr/local/bin/sosearch-start.sh > /tmp/sosearch.log 2>&1 &

查看日志

tail -f /tmp/sosearch.log

API 接口

  • 搜索GET http://127.0.0.1:3000/search?q=关键词
  • 健康检查GET http://127.0.0.1:3000/health