fatwang2/search2ai

这是什么？

核心功能

• 01多个服务商统一的搜索、新闻和网页提取接口
• 02自动服务商回退，并在 warnings 中记录原因
• 03支持本地或远程 MCP、HTTP API 与 TypeScript 库三种接入方式
• 04支持内存缓存和 Cloudflare KV 缓存
• 05为 Exa、Tavily、Search1API、SearXNG、Firecrawl 客户端提供兼容端点

适用场景

• 通过 MCP 为 Claude Desktop、Cursor 等客户端提供网页搜索工具
• 通过 REST 接口为智能体或后端服务提供搜索数据
• 将已有的 Tavily 或 Exa SDK 集成迁移到自托管网关
• 为支持自定义 OpenAI 兼容地址的聊天客户端增加联网搜索能力

快速上手

1. 1

   创建包含搜索服务密钥的 .env 文件

2. 2

   启动本地 HTTP 服务

   npx -y search2ai serve --host 127.0.0.1
3. 3

   在另一个终端中执行搜索

   curl http://localhost:3014/v1/search -H 'Content-Type: application/json' -d '{"query":"hono cloudflare workers","max_results":3}'

使用前须知

• !搜索功能至少需要配置一个服务商，且大多数服务商需要 API 密钥。
• !本地 CLI 和 npm 包要求 Node.js 22.18 或更高版本。
• !部分服务商会忽略某些筛选条件（如国家、语言或日期范围），且不会触发回退。

收录于专题

标签

常见问题

search2ai 是什么？

面向 AI 智能体的自托管搜索网关，通过 MCP、HTTP API 或 TypeScript 库提供统一的搜索、新闻和网页提取，并支持服务商自动回退。 search2ai 位于 AI 智能体或应用与多个搜索、网页提取服务之间。你只需配置已有凭证的服务商，网关即可返回统一结构的结果，包括标题、链接、摘要，以及可选的日期和正文。

search2ai 可以免费使用吗？用的什么许可证？

search2ai 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

search2ai 还在维护吗？

活跃维护中。search2ai 最近一次提交是在 2026年11月2日。

search2ai 适合用来做什么？

通过 MCP 为 Claude Desktop、Cursor 等客户端提供网页搜索工具 通过 REST 接口为智能体或后端服务提供搜索数据 将已有的 Tavily 或 Exa SDK 集成迁移到自托管网关 为支持自定义 OpenAI 兼容地址的聊天客户端增加联网搜索能力

search2ai 怎么安装和运行？

创建包含搜索服务密钥的 .env 文件 启动本地 HTTP 服务: npx -y search2ai serve --host 127.0.0.1 在另一个终端中执行搜索: curl http://localhost:3014/v1/search -H 'Content-Type: application/json' -d '{"query":"hono cloudflare workers","max_results":3}'

在哪里获取 search2ai？

源代码和安装说明在 GitHub 上：https://github.com/fatwang2/search2ai