使用自托管的 SearxNG 搜索 API 进行网络搜索的实战指南

最新推荐文章于 2025-07-26 13:24:59 发布

lirxx

最新推荐文章于 2025-07-26 13:24:59 发布

阅读量436

点赞数 10

CC 4.0 BY-SA版权

文章标签：前端

本文链接：https://blog.csdn.net/lirxx/article/details/149244009

SearxNG 是一个开源的元搜索引擎，可以通过自托管的方式使用其 API 进行网络搜索。本文将深入介绍如何使用 SearxNG API，并提供实用代码示例以帮助你在实际开发中高效利用这一工具。

技术背景介绍

SearxNG 是一个社区驱动的搜索引擎，提供了匿名搜索功能，并支持多个搜索引擎的聚合结果。它允许用户定制搜索查询参数，以满足不同的搜索需求。这对于研究人员、开发者、以及需要定制化搜索解决方案的企业来说，是一种不错的选择。

核心原理解析

SearxNG 的 API 提供了多个参数选项，例如搜索引擎选择、语言设置、结果类别筛选等。通过这些参数，用户可以得到更加精确和相关的搜索结果。

代码实现演示

以下是如何通过 Python 代码使用 SearxNG API 进行搜索的示例：

import pprint
from langchain_community.utilities import SearxSearchWrapper

# 初始化 SearxNG 搜索包装器
search = SearxSearchWrapper(searx_host="http://127.0.0.1:8888", k=5) # k是最大返回条目数

# 执行搜索并限制搜索引擎为 Wikipedia
results = search.run("large language model", engines=["wiki"])
print(results)

在上述代码中，我们使用 SearxSearchWrapper 对象与自托管的 SearxNG API 接口进行交互，并通过 engines 参数指定使用 Wikipedia 进行搜索。

其他参数

此外，我们可以使用其他参数进行搜索，例如语言设定：

# 通过设定语言参数进行搜索
search = SearxSearchWrapper(searx_host="http://127.0.0.1:8888", k=1)
results = search.run("deep learning", language="es", engines=["wiki"])
print(results)

在这个示例中，搜索结果会以西班牙语返回。

获取带元数据的搜索结果

在一些情况下，我们需要从搜索结果中提取更多的信息，例如科学论文的结果。可以使用 resultsmethod 来获取更结构化的信息：

# 获取带有元数据的结果
results = search.results(
    "Large Language Model prompt",
    num_results=5,
    categories="science",
    time_range="year",
)
pprint.pp(results)