fatwang2/search2ai

它解决的问题

AI 代理和聊天客户端需要最新的搜索和页面内容，但依赖单一提供商意味着受限于速率限制、超时和中断。search2ai 允许你配置多个搜索和提取服务，并在提供商失败时自动回退到下一个，因此你的应用程序无需硬编码提供商逻辑即可获得一致的结果。

工作原理

该项目提供多种集成路径：用于 AI 客户端的本地 MCP 服务器（stdio）、独立的 HTTP 服务、JavaScript/TypeScript 库，以及可挂载的 Hono 路由。你可以通过环境变量配置提供商密钥或 URL，并为每个操作（搜索、新闻、爬取）定义回退链。当请求到来时，网关按顺序尝试提供商，返回第一个成功的响应，并报告失败警告。结果被规范化为通用结构（标题、URL、摘要、可选日期和内容）。可选的聊天代理允许支持工具调用的模型提供商在对话期间执行网页搜索。还有兼容性端点，使现有 SDK（例如 Exa、Tavily、SearXNG）可以以最小更改指向此网关。

适用人群

构建 AI 助手、代理或任何需要网页搜索或页面提取的应用程序的开发人员。如果你希望切换或组合提供商，或者需要一个与支持 MCP 的客户端（如 Claude Desktop 或 Cursor）配合使用的自托管端点，它尤其有用。

亮点

• 跨提供商规范化结果：标题、URL、摘要、可选日期/内容。
• 根据配置的提供商支持搜索、新闻和页面提取（爬取）。
• 自由选择提供商；未配置的提供商永远不会自动启用。
• 回退链具有按操作排序、内存和 Cloudflare KV 缓存。
• 多种集成方式：MCP、HTTP API、JS/TS 库、Hono 挂载。
• 为现有 API 客户端提供兼容性端点（SearXNG、Exa、Tavily、Search1API、Firecrawl 单页）。