fatwang2/search2ai

어떤 프로젝트인가요?

핵심 기능

• 01여러 공급자에 걸쳐 검색, 뉴스 검색, 페이지 추출을 통합된 인터페이스로 제공
• 02공급자 장애 시 자동으로 대체 공급자를 시도하고 사유를 warnings에 기록
• 03로컬 또는 원격 MCP 서버, HTTP API, TypeScript 라이브러리 지원
• 04메모리 및 Cloudflare KV 캐싱
• 05Exa, Tavily, Search1API, SearXNG, Firecrawl 클라이언트용 호환성 엔드포인트

활용 사례

• MCP를 통해 Claude Desktop이나 Cursor에 웹 검색 도구 제공
• REST를 통해 에이전트나 백엔드 서비스에 검색 결과 전달
• 기존 Tavily 또는 Exa SDK 연동을 셀프 호스팅 게이트웨이로 전환
• 사용자 지정 OpenAI 호환 base URL을 지원하는 채팅 클라이언트에 웹 액세스 추가

빠른 시작

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 에이전트나 애플리케이션과 여러 검색 및 페이지 추출 서비스 사이에서 동작합니다. 사용할 인증 정보가 있는 공급자를 설정하면 게이트웨이가 제목, URL, 요약문과 선택적 날짜 또는 콘텐츠 필드를 포함한 일관된 형식으로 결과를 반환합니다.

search2ai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

search2ai은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

search2ai은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. search2ai의 마지막 커밋은 2026년 11월 2일입니다.

search2ai은(는) 어디에 사용할 수 있나요?

MCP를 통해 Claude Desktop이나 Cursor에 웹 검색 도구 제공 REST를 통해 에이전트나 백엔드 서비스에 검색 결과 전달 기존 Tavily 또는 Exa SDK 연동을 셀프 호스팅 게이트웨이로 전환 사용자 지정 OpenAI 호환 base URL을 지원하는 채팅 클라이언트에 웹 액세스 추가

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