SearXNG 搜索技能

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

前提条件

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

bash
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: - SEARXNGBASEURL=http://localhost:8080/ restart: unless-stopped EOF

创建启用 JSON API 的 settings.yml

cat > searxng/settings.yml << EOF usedefaultsettings: 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）：
bash
export SEARXNG_URL=http://localhost:8080

使用示例

基本搜索

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

按类别搜索

bash

通用网页搜索

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

按语言/地区搜索

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

分页结果

bash

第2页（结果11-20）

curl http://localhost:8080/search?q=query&pageno=2&format=json

响应格式

每个结果包含：

• - title - 结果标题
• url - 结果链接
• content - 摘要/描述
• engines - 返回此结果的搜索引擎数组
• score - 相关性评分（越高越好）
• category - 结果类别

Shell 函数

添加到您的 .zshrc 或 .bashrc：

bash
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 管理

bash

启动

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

停止

docker compose down

查看日志

docker compose logs -f searxng

重启

docker compose restart

故障排除

容器无法启动：
bash
docker compose logs searxng

JSON 格式无法使用：
确保在 settings.yml 中包含 formats: [html, json]

没有结果：
某些引擎可能受到速率限制。检查日志中的错误信息。

为什么选择 SearXNG？

• - 隐私：无跟踪、无广告、无数据收集
• 聚合：整合来自 70 多个搜索引擎的结果
• 自托管：您的数据保留在您的机器上
• API：支持 JSON 输出，便于自动化
• 免费：无需 API 密钥，无速率限制