SearXNG 搜索

尊重隐私的元搜索引擎，对搜索进行匿名化处理，并从 250 多个引擎聚合结果。

快速开始

使用捆绑脚本进行网络搜索：

python3 scripts/search.py "your query"

返回包含标题、URL 和内容摘要的 JSON 数据。

常见工作流程

基本网络搜索

python3 scripts/search.py "OpenClaw AI agent" --num 5

新闻搜索

python3 scripts/search.py "latest tech news" --categories news

本地化搜索

python3 scripts/search.py "Python Tutorial" --lang de

多类别搜索

python3 scripts/search.py "machine learning" --categories general,science --num 10

Bang 搜索（直接引擎）

# Wikipedia
python3 scripts/search.py "Albert Einstein" --bang w

# YouTube
python3 scripts/search.py "python tutorial" --bang yt

# GitHub
python3 scripts/search.py "openclaw" --bang gh

# Reddit
python3 scripts/search.py "best laptop 2026" --bang r

Bang 搜索比类别搜索更精细，可直接在特定引擎上搜索。

隐私功能

SearXNG 通过多重机制保护您的隐私：

1. 随机化浏览器指纹- 为每个搜索查询生成新的虚假浏览器配置文件（版本、操作系统、屏幕分辨率、语言）
2. IP 地址掩蔽- 搜索引擎看到的是 SearXNG 实例的 IP 地址，而非您的真实 IP
3. 无 Cookie 追踪- 从不向外部搜索引擎转发 Cookie
4. 无来源网站追踪- 目标网站无法追踪您来自哪个搜索引擎
5. 可选Tor/代理- 可通过Tor路由所有查询以增强匿名性

实现效果：搜索引擎无法建立您的用户画像

使用场景

优先选择SearXNG的场景：

• 隐私敏感搜索（无追踪、无画像分析）
• 高频次搜索（无频率限制）
• 具备自托管基础设施时
• 多引擎结果聚合（支持250+搜索引擎）
• 无广告结果

优先选择Brave API (web_search工具) 的场景：

• 需要更快的响应速度
• 需要结构化数据格式
• 可接受使用外部API时

结果处理

脚本返回易于解析和展示的纯净JSON格式：

import json
import subprocess

result = subprocess.run(
    ['python3', 'scripts/search.py', 'query', '--num', '5'],
    capture_output=True,
    text=True
)

data = json.loads(result.stdout)
for item in data['results']:
    print(f"Title: {item['title']}")
    print(f"URL: {item['url']}")
    print(f"Snippet: {item['content']}")
    print()

高级选项

请参阅references/api.md以了解：

• 所有可用的类别
• 特定搜索引擎的搜索
• 语言代码
• 错误处理
• 与Brave搜索API的对比

配置

SearXNG实例

默认情况下，脚本使用http://127.0.0.1:8080。可通过环境变量配置：

export SEARXNG_URL=http://your-searxng-instance.com
python3 scripts/search.py "query"

选项：

• 自托管实例（推荐用于隐私保护）
• 公共实例：https://searx.space（社区运营的服务器）

使用公共实例

如果您没有运行自己的SearXNG：

# Example with public instance
export SEARXNG_URL=https://searx.be
python3 scripts/search.py "query"

注意：公共实例可能有速率限制或比自托管实例速度慢。

技术细节

• 默认URL： http://127.0.0.1:8080（可通过SEARXNG_URL环境变量覆盖）
• 请求方法：HTML解析（JSON接口常因CSRF防护而禁用）
• 解析器：位于scripts/search.py
• 中的自定义HTML解析器超时设置：
• 15秒结果格式：