searxng-search

🔍 隐私优先的开源聚合搜索工具

基于 MCP 协议的 SearXNG 搜索工具,通过自建实例实现隐私保护的网络检索,零外部依赖且代码透明可审计。

收藏
1.8k
安装
434
版本
latest
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

核心用法

searxng-search 是一款基于 MCP(Model Context Protocol)协议的搜索工具,允许用户通过本地或远程 SearXNG 实例执行网络搜索。该技能提供三种主要使用方式:通过 mcporter CLI 调用 MCP 服务器、直接运行 Bash 脚本,或使用标准 HTTP API 请求。用户需预先配置 SEARXNG_URL 环境变量指向自有 SearXNG 实例,支持 JSON、Markdown 和纯文本三种输出格式,可灵活集成到自动化工作流或 AI Agent 系统中。

显著优点

隐私保护能力强:由于采用自建 SearXNG 实例架构,所有搜索请求直接发送至用户控制的服务器,绕过商业搜索引擎的追踪机制,搜索历史与个人信息完全由用户掌控。

零外部依赖风险:Python 实现仅使用标准库(urllib、json、os、sys),Shell 脚本依赖 curl 和 jq 等系统标准工具,无第三方 pip/npm 包引入供应链攻击风险,代码完全透明可审计。

标准化集成:作为 MCP 服务器实现,可与支持 MCP 协议的任何 AI 助手或自动化平台无缝集成,提供统一的工具调用接口。

多格式输出支持:根据使用场景灵活选择 JSON(结构化数据)、Markdown(可读性优先)或纯文本格式,满足不同下游处理需求。

潜在缺点与局限性

基础设施门槛:必须自行部署 SearXNG 实例(Docker 或裸机部署),对非技术用户存在配置复杂性,无现成可用服务时功能完全失效。

来源可信度:作者为个人开发者(T3 来源),虽代码通过安全审计,但长期维护承诺与大型企业或开源组织相比存在不确定性。

功能单一性:仅提供基础搜索能力,缺乏结果缓存、智能摘要、搜索历史管理等增值功能,需配合其他工具构建完整解决方案。

适合的目标群体

该技能特别适合以下用户:注重搜索隐私的技术从业者、需要为 AI Agent 添加安全搜索能力的开发者、命令行工作流爱好者、以及具备自建基础设施能力的隐私倡导者。对于企业用户,适合作为内部知识检索系统的前置搜索组件。

使用风险

网络配置风险:若未使用 HTTPS 协议配置 SEARXNG_URL,搜索查询可能在传输过程中被截获,建议在公网部署时强制启用 TLS 加密。

依赖可用性:功能完全依赖用户自建 SearXNG 实例的在线状态,实例宕机或网络不可达时将导致服务中断,需自行实现高可用方案。

输入处理边界:虽然代码实现了 URL 编码和基础参数校验,但极长查询字符串或特殊构造的搜索词可能影响 SearXNG 实例性能,建议在生产环境添加查询长度限制。

安全解读

核心用法

searxng-search 是一款基于 MCP(Model Context Protocol)协议的网页搜索工具,允许用户通过自有或可信的 SearXNG 实例执行隐私友好的网络搜索。该 Skill 提供三种使用方式:通过 mcporter CLI 调用 MCP 服务器、直接运行 Bash 脚本,或直接使用 curl 访问 SearXNG API。

配置流程简单,仅需设置 SEARXNG_URL 环境变量指向个人 SearXNG 实例,即可通过 mcporter call searxng.web_search query="关键词" 完成搜索。支持 text、json、markdown 三种输出格式,便于不同场景下的结果处理。

显著优点

1. 隐私优先架构:所有搜索请求直接发往用户自主控制的 SearXNG 实例,绕过商业搜索引擎的数据收集,符合 GDPR/CCPA 合规要求。
2. 零第三方依赖:Python 服务端仅使用标准库实现,无 pip 依赖包,彻底消除供应链攻击风险。

3. MCP 原生集成:作为标准 MCP Server,可与 Claude、Cursor 等支持 MCP 的 AI 助手无缝协作,扩展大模型的实时信息获取能力。

4. 轻量可移植:代码仅 445 行(Python + Shell),支持快速部署在本地、VPS 或容器环境中。

5. 透明可信:MIT 开源协议,无混淆代码或网络行为,安全审计评级 A 级(82 分)。

潜在缺点与局限性

1. 基础设施依赖:必须自行部署或获取可信的 SearXNG 实例,对技术门槛有一定要求;公共实例可用性不稳定。
2. 功能相对基础:仅支持标准网页搜索,不具备图片/视频搜索、搜索建议、结果排名优化等高级特性。

3. 无内置容错机制:Bash 脚本缺少超时控制,网络波动时可能挂起;错误提示较为简略。

4. HTTPS 非强制:当前版本接受 HTTP 协议配置,存在中间人攻击风险,需用户自行确保实例启用 TLS。

适合人群

  • 隐私敏感用户:希望避免搜索记录被商业平台追踪的技术爱好者
  • 自托管爱好者:已部署或计划部署 SearXNG、HomeLab 基础设施的用户
  • AI 工作流搭建者:需要将实时搜索结果集成到 Claude、Cursor 等 MCP 客户端的开发者
  • 企业合规场景:对数据出境和第三方 SaaS 有严格限制的组织

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 实例信任风险 | 搜索内容发送至用户配置的 SearXNG 实例,若实例被篡改可截获查询 | 使用自建实例或可信社区实例,启用 HTTPS 并验证证书 |
| 传输安全风险 | HTTP 配置时搜索关键词明文传输 | 强制使用 HTTPS URL,定期检查 TLS 配置 |
| 维护持续性风险 | T3 来源(个人开发者),长期更新保障不确定 | 关注 GitHub 仓库动态,考虑 fork 后自行维护 |
| 功能边界风险 | 依赖 SearXNG 实例本身的搜索质量和反爬能力 | 选择维护良好的实例,必要时多实例冗余 |

该 Skill 适合作为隐私优先搜索工作流的基础组件,建议配合 HTTPS 强制策略和定期安全审计使用。

searxng-search 内容

手动下载zip · 4.4 kB
config.jsonapplication/json
请选择文件