SearXNG 搜索技能

使用您自托管的 SearXNG 实例进行网页搜索。这是一款尊重隐私的元搜索引擎，可聚合来自 Google、DuckDuckGo、Brave、Startpage 以及 70 多个其他搜索引擎的结果。

前提条件

本地或服务器上已运行 SearXNG。快速 Docker 部署方式如下：

mkdir -p ~/Projects/searxng/searxng
cd ~/Projects/searxng

# 创建 docker-compose.yml
cat > docker-compose.yml << 'EOF'
services:
  searxng:
    image: searxng/searxng:latest
    container_name: searxng
    ports:
      - "8080:8080"
    volumes:
      - ./searxng:/etc/searxng:rw
    environment:
      - SEARXNG_BASE_URL=http://localhost:8080/
    restart: unless-stopped
EOF

# 创建启用 JSON API 的 settings.yml
cat > searxng/settings.yml << 'EOF'
use_default_settings: true
server:
  secret_key: "change-me-to-random-string"
  bind_address: "0.0.0.0"
  port: 8080
search:
  safe_search: 0
  autocomplete: "google"
  default_lang: "en"
  formats:
    - html
    - json
EOF

# 启动 SearXNG
docker compose up -d

配置

设置 SearXNG URL（默认为 http://localhost:8080）：

export SEARXNG_URL="http://localhost:8080"

使用示例

基础搜索

curl "http://localhost:8080/search?q=your+query&format=json" | jq '.results[:5]'

按分类搜索

# 通用网页搜索
curl "http://localhost:8080/search?q=query&categories=general&format=json"

# 图片
curl "http://localhost:8080/search?q=query&categories=images&format=json"

# 新闻
curl "http://localhost:8080/search?q=query&categories=news&format=json"

# 视频
curl "http://localhost:8080/search?q=query&categories=videos&format=json"

# IT/技术文档
curl "http://localhost:8080/search?q=query&categories=it&format=json"

# 科学/学术
curl "http://localhost:8080/search?q=query&categories=science&format=json"

指定语言/地区搜索

curl "http://localhost:8080/search?q=query&language=en-US&format=json"
curl "http://localhost:8080/search?q=query&language=de-DE&format=json"

分页结果

# 第 2 页（第 11–20 条结果）
curl "http://localhost:8080/search?q=query&pageno=2&format=json"

响应格式

每条结果包含以下字段：

• title — 结果标题
• url — 结果链接
• content — 摘要/描述
• engines — 返回该结果的搜索引擎数组
• score — 相关性得分（数值越高表示越相关）
• category — 结果所属分类

Shell 函数

将以下函数添加至您的 .zshrc 或 .bashrc 文件中：

searxng() {
  local query="$*"
  local url="${SEARXNG_URL:-http://localhost:8080}"
  curl -s "${url}/search?q=$(echo "$query" | sed 's/ /+/g')&format=json" | 
    jq -r '.results[:10][] | "[(.score | floor)] (.title)n    (.url)n    (.content // "No description")n"'
}

使用方式：searxng how to make sourdough bread

Docker 管理

# 启动
cd ~/Projects/searxng && docker compose up -d

# 停止
docker compose down

# 查看日志
docker compose logs -f searxng

# 重启
docker compose restart

故障排查

容器无法启动：

docker compose logs searxng

JSON 格式不可用：
请确认 settings.yml 中已包含 formats: [html, json]

无搜索结果：
部分搜索引擎可能存在请求频率限制。请检查日志中是否有错误信息。

为何选择 SearXNG？

• 隐私保护：不追踪用户行为、无广告、不收集任何数据
• 结果聚合：整合来自 70 多个搜索引擎的结果
• 自托管：您的所有数据保留在您自己的设备上
• API 支持：提供 JSON 输出，便于自动化集成
• 完全免费：无需 API 密钥，亦无调用频率限制