SearXNG命令行工具：提升终端搜索效率的利器

**SearXNG** 是一款受 `ddgr` 和 `googler` 启发的命令行工具，它允许用户直接在终端中使用 SearXNG 实例进行网络搜索。它提供了丰富格式的搜索结果，并支持各种搜索类别和高级过滤选项，从而极大地提升了在终端进行信息检索的效率。

**主要特点：**

* **终端界面与彩色输出：** SearXNG 提供了基于终端的交互界面，并使用彩色输出，让搜索结果更易于阅读和理解。
* **搜索引擎选择：** 支持多种搜索引擎，包括 Bing、DuckDuckGo、Google 等，用户可以根据需要选择使用不同的搜索引擎。
* **搜索类别支持：** 支持多种搜索类别，例如：常规、新闻、图片、视频、科学、IT、文件、社交媒体等，方便用户针对特定领域进行搜索。
* **安全搜索过滤：** 提供安全搜索过滤功能，包括“无”、“适中”和“严格”三种模式，满足不同用户的安全需求。
* **时间范围过滤：** 支持按时间范围过滤搜索结果，例如：今天、本周、本月、今年等，方便用户查找特定时间段内的信息。
* **JSON 输出选项：** 提供 JSON 格式的输出选项，方便用户进行脚本编写和自动化处理。
* **自动配置：** 首次运行时会自动进行配置，简化了安装和设置过程。
* **跨平台支持：** 支持 macOS、Linux 和 Windows 等多种操作系统。

**安装与配置：**

SearXNG 的安装需要使用 `uv` 包管理器。用户可以通过以下命令进行安装：

“`bash
uv tool install https://github.com/scross01/searxngr.git
“`

或者，用户也可以从源码进行安装：

“`bash
git clone https://github.com/scross01/searxngr.git
cd searxngr
uv venv && source .venv/bin/activate # (可选)
uv sync
uv tool install .
“`

SearXNG 的配置文件位于 `$XDG_CONFIG_HOME/searxng/config.ini`。在 Mac 和 Linux 系统上，通常位于 `$HOME/.config` 目录下；在 Windows 系统上，则位于 `%APPDATA%` 目录下。如果配置文件不存在，SearXNG 会自动创建并填充一个默认的配置模板。首次运行时，SearXNG 会提示用户输入 SearXNG 实例的 URL，并将其写入配置文件。

配置文件示例：

“`ini
[searxngr]
searxng_url = https://searxng.example.com
results_per_page = 10
safe_mode = moderate
expand = false
engines = duckduckgo google brave
“`

**使用方法：**

SearXNG 的基本使用方法如下：

“`bash
searxngr [搜索关键词]
“`

例如，要搜索“为什么天空是蓝色的”，可以使用以下命令：

“`bash
searxngr 为什么天空是蓝色的
“`

SearXNG 还提供了丰富的命令行选项，用于修改输出和覆盖配置文件的默认设置。常用的选项包括：

* `-h, –help`: 显示帮助信息。
* `–searxng-url SEARXNG_URL`: 指定 SearXNG 实例的 URL。
* `-c, –categories [CATEGORY …]`: 指定搜索类别，例如：`general`, `news`, `videos` 等。
* `-e, –engines [ENGINE …]`: 指定使用的搜索引擎。
* `-n, –num N`: 指定每页显示的搜索结果数量。
* `–safe-search FILTER`: 指定安全搜索过滤模式，例如：`none`, `moderate`, `strict`。
* `-t, –time-range TIME_RANGE`: 指定搜索结果的时间范围，例如：`day`, `week`, `month`, `year`。
* `–json`: 以 JSON 格式输出搜索结果。

**故障排除：**

如果遇到 `429 Too Many Requests` 错误，说明 SearXNG 服务器限制了访问搜索 API 的频率。可以尝试更新服务器的限制设置，或者禁用私有实例的限制器。

如果遇到无法解码 JSON 响应的错误，说明 SearXNG 实例返回的是 HTML 格式的结果。需要在 SearXNG 服务器上修改支持的搜索格式，将 JSON 添加到 `searxng/settings.yml` 文件中。

**总结：**

SearXNG 是一款功能强大的命令行工具，它允许用户直接在终端中使用 SearXNG 实例进行网络搜索，并提供了丰富的搜索选项和过滤功能。通过 SearXNG，用户可以更加高效地在终端进行信息检索，从而提升工作效率。

**SEO 关键词：**

SearXNG, 命令行搜索, 终端搜索

**标签：**

命令行工具, 搜索, 效率

scross01/searxngr: SearXNG from the command line, inspired by `ddgr` and `googler`.
https://github.com/scross01/searxngr