SearXNG 搜索技能

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

先决条件

在本地或服务器上运行 SearXNG。快速 Docker 设置：

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

# Create 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

# Create settings.yml with JSON API enabled
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

# Start 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]'

按类别搜索

# General web search
curl "http://localhost:8080/search?q=query&categories=general&format=json"

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

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

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

# IT/Tech documentation
curl "http://localhost:8080/search?q=query&categories=it&format=json"

# Science/Academic
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"

分页结果

# Page 2 (results 11-20)
curl "http://localhost:8080/search?q=query&pageno=2&format=json"

响应格式

每个结果包括：

• 标题- 结果标题
• 网址- 结果链接
• 内容- 摘要/描述
• 搜索引擎- 返回此结果的搜索引擎数组
• 分数- 相关度分数（数值越高越好）
• 类别- 结果类别

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 如何制作酸面包

Docker 管理

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

# Stop
docker compose down

# View logs
docker compose logs -f searxng

# Restart
docker compose restart

故障排除

容器无法启动：

docker compose logs searxng

JSON 格式不工作：请确保formats: [html, json]已包含在您的 settings.yml 文件中

无结果：某些引擎可能被限流。请检查日志以查找错误。

为什么选择 SearXNG？

• 隐私保护无追踪、无广告、无数据收集
• 聚合：整合70多个搜索引擎的结果
• 自托管：您的数据仅存储在本地设备
• API：提供JSON输出以支持自动化
• 免费：无需API密钥或速率限制