SearXNG AI Kit 实战：给 Claude Code 和 Codex 装上隐私保护的 180+ 搜索引擎

AI 编码 Agent（Claude Code、Codex、Cursor）的能力上限往往取决于它们能获取多少外部信息。需要查 API 文档？搜最新库版本？找技术博客？没有搜索引擎接入的 Agent，就像程序员没有浏览器——只能靠训练数据里的旧知识。

传统的做法是给 Agent 配一个 SerpAPI 或 Tavily API Key，但问题有两个：一是这些 API 都有用量和费用限制，二是所有搜索请求都经过第三方服务商，隐私上不太踏实。

SearXNG AI Kit 正是为了解决这个问题而生的开源工具。它把自我托管的 SearXNG 元搜索引擎（聚合 180+ 搜索引擎的隐私友好型引擎）打包成一个可直接运行的 CLI 工具、Python 库和 MCP 服务器——无需部署 SearXNG 服务端，一个命令就能让你的 AI Agent 拥有完整的搜索能力。

什么是 SearXNG AI Kit？

简单来说，SearXNG AI Kit 是一个”开箱即用的 AI 搜索工具包”。它把 SearXNG（AGPL-3.0 开源的隐私元搜索引擎）与 AI 能力整合在一起，通过三个接入方式覆盖不同场景：

核心技术栈是 Python 3.11+，使用 uv 作为包管理，发布平台覆盖 Linux 和 macOS。

安装

最简安装（推荐二进制）

从 GitHub Releases 页面下载预编译的可执行文件：

chmod +x searxng-ai-kit-*
sudo mv searxng-ai-kit-* /usr/local/bin/searxng

searxng --help

uv 源码安装

curl -LsSf https://astral.sh/uv/install.sh | sh

git clone https://github.com/nikvdp/searxng-ai-kit
cd searxng-ai-kit
uv run python dev-setup.py
uv tool install .

searxng --help

CLI 实战：四种搜索姿势

1. 基础搜索

searxng search "python asyncio tutorial"

searxng search "rust memory safety" --engines duckduckgo,startpage

searxng search "react server components" --category it

searxng search "langchain agent" --format json > results.json

2. URL 内容获取

这是对 AI 编码场景最有用的功能之一——不仅能搜到结果，还能直接把链接内容提取出来给 Agent 用：

searxng fetch-urls "https://docs.python.org/3/library/asyncio.html"

searxng fetch-urls "https://site1.com" "https://site2.com" "https://site3.com"

searxng fetch-urls url1 url2 --concurrent 2

3. AI 问答搜索

SearXNG AI Kit 内建了 AI 聊天功能——它在搜索后会自动调用 AI 模型对结果进行分析和总结：

searxng ask "2026 年最值得关注的 AI 编码工具趋势"

searxng ask "Compare Python vs JavaScript async patterns" \
  --model "openai/gpt-4o-mini"

searxng chat

searxng chat --model "openrouter/anthropic/claude-3.5-sonnet"

聊天模式下支持会话记忆——你可以连续追问：”今天东京天气怎么样？” → “那明天呢？” → “我该穿什么？”——Agent 会自动记住上下文。

4. 引擎管理

searxng engines

searxng engines --common

searxng categories

MCP 服务器集成：给 AI Agent 装上网

这才是 SearXNG AI Kit 真正的亮点——MCP 服务器模式。你不需要给 Claude Code 或 Codex 写任何胶水代码，启动 MCP 服务器后，Agent 自动获得 5 个搜索工具：

searxng mcp-server

然后配置到 Claude Desktop（或在 Claude Code 中通过 mcp add 添加）：

{
  "mcpServers": {
    "searxng": {
      "command": "searxng",
      "args": ["mcp-server"]
    }
  }
}

MCP 服务器暴露的工具列表：

接入后，你的 Claude Code 就可以这样工作了：

用户：”查一下 FastAPI 最新的依赖注入模式” Claude Code：调用 web_search → 获取 DuckDuckGo/Startpage 结果 → 调用 fetch_url 提取文档内容 → 给出完整答案

Python 库用法

在你的项目中直接作为依赖使用：

import searxng

results = searxng.search("python tutorial", max_results=10)

content = searxng.fetch_url("https://example.com")

response = searxng.ask("最新的 AI Agent 框架有哪些？")

client = searxng.SearXNGClient(
    default_engines=["duckduckgo", "startpage"],
    default_max_results=15
)

所有函数都有异步版本（search_async、fetch_url_async、ask_async），适合集成到 asyncio 应用中。

小技巧与最佳实践

加速搜索：首次启动时搜索引擎需要初始化，后续查询会快很多。用 --engines duckduckgo 指定少量引擎可以显著加快速度。

隐私优先：所有搜索通过 SearXNG 的元搜索引擎完成——你的查询不会直接暴露给 Google 或 Bing，搜索引擎也不会获取你的 IP 和 User-Agent。

持续对话：searxng chat 的聊天记录自动保存到 ~/.local/share/searxng-ai-kit/chats/，方便回溯之前的搜索结果。

配合 CLI Proxy API：SearXNG AI Kit 支持 CLI Proxy API 集成，可以用已有的 Claude Pro、ChatGPT Plus 订阅使用 AI 问答功能，无需额外 API Key。

总结

SearXNG AI Kit 解决了一个很实际的问题：给 AI 编码 Agent 装上搜索引擎，而且是隐私保护、无需 API Key、180+ 引擎的完整搜索生态。CLI 直接可用、Python 库可集成、MCP 服务器一键接入——三种形态覆盖了从终端用户到开发者的全部场景。

对于那些不想为 Tavily 或 SerpAPI 付费、同时又希望 Agent 保持最新搜索能力的团队来说，这是一个相当理想的开源替代方案。只需要一个 searxng mcp-server 命令，你的 Claude Code 和 Codex 就能像开发者一样自由地搜索整个互联网。

相关链接

• GitHub 仓库（AGPL-3.0）
• SearXNG 官网
• CLI Proxy API 集成
• GitHub Releases 页面