客户端 API 迁移

把 SearXNG 客户端迁到托管搜索

保留支持的 SearXNG JSON 请求和结果解析，在 Open WebUI、LangChain 等客户端中把实例 URL 换成 Search1API。

Open WebUI — bash diff
-SEARXNG_QUERY_URL="http://searxng:8080/search?q=<query>"
+SEARXNG_QUERY_URL="https://api.search1api.com/compat/searxng/YOUR_SEARCH1API_KEY/search?q=<query>"

什么时候适合迁移

如果维护实例、开启 JSON 输出或公共实例不可用正在影响应用，可以把支持的搜索调用迁到托管端点。Search1API 兼容的是 SearXNG 客户端协议，不是托管一个 SearXNG 实例，也没有名为 SearXNG 的搜索引擎。

原服务参考资料: SearXNG Search API

可以保留什么

results[].title、url、content 等 SearXNG JSON 结果字段。
支持的引擎名称、分类、查询 bang 和语言前缀。
现有 Open WebUI、LangChain 的 SearXNG 客户端接入方式。

切换前需要确认

结果由 Search1API 提供，不导入原实例的插件、私有引擎、偏好或隐私策略。
不支持的引擎出现在 unresponsive_engines；全部不支持时使用分类或默认网页搜索。safesearch 等选项会被忽略。
API key 放在实例 URL 中，请保密。每个被搜索的引擎消耗 1 credit，同时选择多个引擎会增加费用。

迁移现有客户端

为该客户端创建 Search1API key，单独创建的 key 可以独立吊销。
按下方示例替换实例地址或查询 URL，客户端仍选择 SearXNG。
用自己的查询验证引擎、分类、被忽略的选项和积分用量。

LangChain · SearxSearchWrapper — python
from langchain_community.utilities import SearxSearchWrapper
search = SearxSearchWrapper(
    searx_host="https://api.search1api.com/compat/searxng/YOUR_SEARCH1API_KEY"
)
results = search.results("hono workers", num_results=5, engines=["google"])
for item in results:
    print(item["title"], item["link"])

示例与兼容技术文档保持一致。切换生产流量前，请用自己的查询验证过滤条件和结果处理。

客户端示例:Open WebUI / LangChain查看兼容技术文档

搜索使用 Search1API 积分，计入账户原有速率限制。读取页面全文或同时选择多个引擎可能增加费用，请查看各协议的计费说明。

查看定价

迁移常见问题

还需要安装 SearXNG 吗？

不需要。把兼容 SearXNG 的客户端指向 Search1API 托管端点即可，无需在本地运行 SearXNG、维护 settings.yml 或开启 JSON 输出。

能完全复现我的自建实例吗？

支持的请求与响应格式可以保留，搜索来源、排序、插件、元数据和隐私属性可能不同。如果应用依赖这些控制能力，可以继续保留自建实例。

SearXNG 的网页界面也能迁移吗？

这里迁移的是调用 JSON 搜索 API 的应用，不会替换 SearXNG 网站，也不导入它的界面和配置。