SearXNG 网络搜索

尊重隐私的网络搜索技能，由 SearXNG 驱动。SearXNG 是一个免费元搜索引擎，
聚合来自 243+ 个搜索服务的结果，且不追踪用户。

从 PulseBot 内置的网络搜索技能重写而来，使用 SearXNG 作为后端，
打包为独立的 agentskills.io 技能。

先决条件

1. 1. 一个运行中的 SearXNG 实例（自托管或可访问的端点）
2. 必须在 SearXNG 的 settings.yml 中启用 JSON 格式：

yaml
search:
formats:
- html
- json

1. 3. 安装 Python requests 库

配置

该技能使用环境变量进行配置：

使用方法

运行搜索脚本：

bash
python scripts/searxng_search.py 你的搜索查询

带选项运行：

bash
python scripts/searxng_search.py 最新AI新闻 \
--categories news \
--language en \
--time-range day \
--max-results 5

输出格式

脚本以 JSON 格式输出到标准输出，结构如下：

json
{
query: 搜索查询,
results: [
{
title: 结果标题,
url: https://example.com,
snippet: 来自页面的文本片段...,
engines: [google, bing],
score: 9.0,
category: general,
published_date: 2025-01-01T00:00:00
}
],
suggestions: [相关查询1, 相关查询2],
answers: [直接答案（如果有）],
total_results: 10,
error: null
}

如果发生错误，results 将为空，error 将包含错误信息。

作为 Python 模块使用

你也可以直接导入并使用搜索函数：

python
from scripts.searxng_search import SearXNGSearchTool

tool = SearXNGSearchTool(base_url=http://localhost:8080)
results = tool.search(量子计算, categories=science,it, max_results=5)

for r in results[results]:
print(f[{r[title]}]({r[url]}))
print(f {r[snippet]})

与 PulseBot 集成

要在 PulseBot 中注册此技能，将其放置在 skills/ 目录下，PulseBot
将通过 SKILL.md 的前置元数据自动发现它。Python 脚本也可以通过
封装作为工具函数调用：

python
from skills.searxngwebsearch.scripts.searxng_search import SearXNGSearchTool

tool = SearXNGSearchTool()

def websearch(query: str, categories: str = general, maxresults: int = 10) -> str:
使用 SearXNG 搜索网络。返回 JSON 格式结果。
result = tool.search(query, categories=categories, maxresults=maxresults)
return json.dumps(result, indent=2)

边界情况

• - 如果 SearXNG 无法访问，脚本返回结构化错误，error 字段被设置
• 如果未找到结果，results 为空列表（不是错误）
• 某些搜索引擎可能无响应；在详细模式下检查 unresponsive_engines
• 受速率限制的公共实例可能返回 429；建议使用自托管实例
• 包含特殊字符的查询会自动进行 URL 编码

SearXNG 设置（快速开始）

有关部署 SearXNG 的详细信息，请参见 references/REFERENCE.md。

bash
docker run -d --name searxng -p 8080:8080 \
-v $(pwd)/searxng:/etc/searxng \
searxng/searxng:latest

然后编辑 /etc/searxng/settings.yml，在 search.formats 中添加 json。