fatwang2/search2ai

해결하는 문제

search2ai는 AI 에이전트를 위한 자체 호스팅 검색 게이트웨이입니다. 단일 검색 제공자에 의존하는 문제를 해결하기 위해 Tavily, Brave, Exa, Serper, SerpApi, Google, SearXNG 등의 여러 검색 엔진을 하나의 Perplexity 호환 API로 통합합니다. 이로 인해 하나의 제공자가 실패하거나, 요청 제한에 도달하거나 타임아웃이 발생할 경우 자동으로 다음 제공자로 전환하는 폴백 체인을 통해 높은 가용성을 보장합니다.

작동 방식

이 프로젝트는 기반 제공자에 관계없이 일관된 스키마(title, url, snippet, date)를 제공합니다. 라이브러리, HTTP 서비스, Claude나 Cursor와 같은 도구용 Model Context Protocol (MCP) 서버로 배포하거나 Hono 애플리케이션에 통합할 수 있습니다. 주요 기능은 일반 검색, 뉴스 검색, 웹 크롤링입니다. 사용자는 사용하고자 하는 제공자의 API 키를 직접 제공합니다.

대상 사용자

• AI 에이전트 개발자: 여러 다른 API를 관리하지 않고도 신뢰성 있고 표준화된 검색 및 크롤링 기능을 갖춘 에이전트를 개발하고 싶은 사람.
• LLM 클라이언트 사용자: NextChat이나 Cherry Studio와 같은 클라이언트를 사용하면서 모델에 웹 검색 기능을 프록시를 통해 추가하고 싶은 사람.
• MCP 사용자: Claude Desktop이나 Cursor를 사용하면서 AI 환경에 직접 검색 도구를 통합하고 싶은 사람.

주요 특징

• 자동 폴백 체인: 요청 제한, 타임아웃, 오류 발생 시 자동으로 제공자를 전환하여 검색 결과의 중단을 방지합니다.
• Perplexity 호환 API: Perplexity Search API와 동일한 스키마를 사용하므로, 제공자 전환 시 코드를 변경할 필요가 없습니다.
• 크롤링 및 뉴스 기능: 기본 검색 외에도 전용 뉴스 엔드포인트와 페이지 콘텐츠 크롤링을 지원합니다.
• 유연한 배포 옵션: Node.js, Cloudflare Workers, Bun, Docker를 지원합니다.
• MCP 통합: Model Context Protocol에 내장된 지원으로 AI 에이전트의 도구로 사용할 수 있습니다.
• 레거시 프록시 모드: 연결되지 않은 LLM 클라이언트에 검색 도구를 주입하는 프록시로 작동할 수 있습니다.