{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Searxng Search

通过 SearXNG 免费元搜索（meta-search）——聚合 70+ 搜索引擎的结果。可自托管或使用公共实例。无需 API 密钥。当 web 搜索工具集不可用时自动回退。

Skill 元数据


来源	可选 — 使用 `hermes skills install official/research/searxng-search` 安装
路径	`optional-skills/research/searxng-search`
版本	`1.0.0`
作者	hermes-agent
许可证	MIT
平台	linux, macos
标签	`search`, `searxng`, `meta-search`, `self-hosted`, `free`, `fallback`
相关 skill	`duckduckgo-search`, `domain-intel`

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。

SearXNG Search

使用 SearXNG 进行免费元搜索——这是一个注重隐私的自托管搜索聚合器，可同时查询 70+ 搜索引擎。

使用公共实例时无需 API 密钥。也可自托管以获得完全控制权。当主 web 搜索工具集（FIRECRAWL_API_KEY）未配置时，自动作为回退方案出现。

配置

SearXNG 需要一个 SEARXNG_URL 环境变量，指向你的 SearXNG 实例：

如果未配置实例，此 skill 不可用，agent 将回退到其他搜索选项。

检测流程

在选择方案之前，先检查实际可用的内容：

决策树：

如果 SEARXNG_URL 已设置且实例响应，则使用 SearXNG

如果 SEARXNG_URL 未设置或不可访问，则回退到其他可用搜索工具

如果用户明确需要 SearXNG，帮助他们搭建实例或找到公共实例

方法一：通过 curl 使用 CLI（推荐）

通过 terminal 使用 curl 调用 SearXNG JSON API。这样可以避免假设安装了特定的 Python 包。

常用 CLI 参数

参数	说明	示例
`q`	查询字符串（URL 编码）	`q=python+async`
`format`	输出格式：`json`、`csv`、`rss`	`format=json`
`engines`	逗号分隔的引擎名称	`engines=google,bing,ddg`
`limit`	每个引擎的最大结果数（默认 10）	`limit=5`
`categories`	按分类过滤	`categories=news,science`
`safesearch`	0=无，1=适中，2=严格	`safesearch=0`
`time_range`	过滤：`day`、`week`、`month`、`year`	`time_range=week`

解析 JSON 结果

每条结果返回：title、url、content（摘要）、engine、parsed_url、img_src、thumbnail、author、published_date

方法二：通过 `requests` 使用 Python API

直接从 Python 使用 requests 库调用 SearXNG REST API：

方法三：searxng-data Python 包

如需更结构化的访问，安装 searxng-data 包：

注意：此包仅提供引擎元数据，不提供搜索 API 本身。

自托管 SearXNG

运行你自己的 SearXNG 实例：

或通过 pip 安装：

公共 SearXNG 实例可在以下地址找到：

https://searxng.example.com（替换为任意公共实例）

工作流：先搜索后提取

SearXNG 返回标题、URL 和摘要——而非完整页面内容。要获取完整页面内容，先搜索，然后使用 web_extract、浏览器工具或 curl 提取最相关的 URL。

限制

实例可用性：如果 SearXNG 实例宕机或不可访问，搜索将失败。始终检查 SEARXNG_URL 已设置且实例可访问。

无内容提取：SearXNG 返回摘要，而非完整页面内容。使用 web_extract、浏览器工具或 curl 获取完整文章。

速率限制：部分公共实例会限制请求。自托管可避免此问题。

引擎覆盖范围：可用引擎取决于 SearXNG 实例的配置，部分引擎可能被禁用。

结果时效性：元搜索聚合外部引擎——结果时效性取决于这些引擎。

故障排查

问题	可能原因	处理方式
`SEARXNG_URL` 未设置	未配置实例	使用公共 SearXNG 实例或自行搭建
连接被拒绝	实例未运行或 URL 错误	检查 URL 是否正确且实例正在运行
结果为空	实例屏蔽了该查询	尝试其他实例或自托管
响应缓慢	公共实例负载过高	自托管或使用负载较低的公共实例
不支持 `json` 格式	SearXNG 版本过旧	尝试 `format=rss` 或升级 SearXNG

注意事项

务必设置 SEARXNG_URL：没有它，此 skill 无法运行。

对查询进行 URL 编码：curl 中的空格和特殊字符必须进行 URL 编码，或在 Python 中使用 urllib.parse.quote()。

使用 format=json：默认格式可能不是机器可读的。始终明确请求 JSON。

设置超时：始终使用 --max-time 或 timeout=，以避免在实例不可访问时挂起。

自托管最佳：公共实例可能宕机、限速或屏蔽请求。自托管实例更可靠。

实例发现

如果 SEARXNG_URL 未设置且用户询问 SearXNG，帮助他们：

找到公共 SearXNG 实例（搜索"public searxng instance"）

使用 Docker 或 pip 搭建自己的实例

公共实例列表：https://searxng.org/

"Searxng Search — 通过 SearXNG 免费元搜索 — 聚合 70+ 搜索引擎的结果"

Searxng Search#

Skill 元数据#

参考：完整 SKILL.md#

SearXNG Search#

配置#

检测流程#

方法一：通过 curl 使用 CLI（推荐）#

常用 CLI 参数#

解析 JSON 结果#

方法二：通过 requests 使用 Python API#

方法三：searxng-data Python 包#

自托管 SearXNG#

工作流：先搜索后提取#

限制#

故障排查#

注意事项#

实例发现#

Searxng Search

Skill 元数据

参考：完整 SKILL.md

SearXNG Search

配置

检测流程

方法一：通过 curl 使用 CLI（推荐）

常用 CLI 参数

解析 JSON 结果

方法二：通过 `requests` 使用 Python API

方法三：searxng-data Python 包

自托管 SearXNG

工作流：先搜索后提取

限制

故障排查

注意事项

实例发现