fatwang2/search2ai

해결하는 문제

AI 에이전트와 채팅 클라이언트는 최신 검색과 페이지 콘텐츠가 필요하지만, 단일 공급자에 의존하면 속도 제한, 시간 초과, 중단의 영향을 받기 쉽습니다. search2ai를 사용하면 여러 검색 및 추출 서비스를 구성할 수 있고, 공급자가 실패하면 자동으로 다음 공급자로 폴백하므로 공급자 로직을 하드코딩하지 않고도 일관된 결과를 얻을 수 있습니다.

작동 방식

이 프로젝트는 여러 통합 경로를 제공합니다: AI 클라이언트용 로컬 MCP 서버(stdio), 독립 HTTP 서비스, JavaScript/TypeScript 라이브러리, 마운트 가능한 Hono 라우트. 환경 변수를 통해 공급자 키 또는 URL을 구성하고, 작업(검색, 뉴스, 크롤)별로 폴백 체인을 정의합니다. 요청이 들어오면 게이트웨이는 공급자를 순서대로 시도하고 첫 번째 성공 응답을 반환하며 실패에 대한 경고를 보고합니다. 결과는 공통 구조(제목, URL, 스니펫, 선택적 날짜 및 콘텐츠)로 정규화됩니다. 선택적 채팅 프록시를 사용하면 도구 호출을 지원하는 모델 공급자가 대화 중에 웹 검색을 수행할 수 있습니다. 또한 기존 SDK(예: Exa, Tavily, SearXNG)가 최소한의 변경으로 이 게이트웨이를 가리킬 수 있는 호환성 엔드포인트도 있습니다.

대상 사용자

AI 어시스턴트, 에이전트 또는 웹 검색이나 페이지 추출이 필요한 모든 앱을 구축하는 개발자. 공급자를 전환하거나 결합하려는 경우, 또는 Claude Desktop이나 Cursor와 같은 MCP 지원 클라이언트와 작동하는 자체 호스팅 엔드포인트가 필요한 경우 특히 유용합니다.

주요 기능

• 공급자 간 정규화된 결과: 제목, URL, 스니펫, 선택적 날짜/콘텐츠.
• 구성된 공급자에 따라 검색, 뉴스, 페이지 추출(크롤) 지원.
• 공급자를 자유롭게 선택; 구성되지 않은 공급자는 자동으로 활성화되지 않습니다.
• 작업별 순서, 인메모리 및 Cloudflare KV 캐싱을 갖춘 폴백 체인.
• 여러 통합 스타일: MCP, HTTP API, JS/TS 라이브러리, Hono 마운트.
• 기존 API 클라이언트용 호환성 엔드포인트(SearXNG, Exa, Tavily, Search1API, Firecrawl 단일 페이지).