wigolo 운영 중

wigolo는 MCP를 통해 Claude Code, Cursor 등의 프로그래밍 Agent에 연결할 수 있는 오픈 소스 로컬 검색 도구입니다. API Key 없이 무료로 로컬에서 검색, 웹페이지 가져오기, 전체 사이트 크롤링, 구조화된 데이터 추출, 캐싱 및 리서치를 수행할 수 있습니다. 18개의 검색 엔진을 병렬로 조회하며, 결과에는 설명 가능한 점수와 원문 인용이 포함됩니다. 모든 데이터는 로컬에 저장됩니다.

WeChat에서 팔로우한 후 “오픈 소스”라고 답장하여 AI 오픈 소스 프로젝트交流群에 참여하세요
search: 18개의 검색 엔진을 병렬로 호출하고, 디바이스 측 ML로 재정렬하여 설명 가능한 점수가 포함된 검색 결과를 반환합니다.
fetch: 계층형 라우팅으로 웹페이지를 가져옵니다. 순수 HTTP에서 헤드리스 브라우저로 자동 전환하여 안티봇과 SPA 페이지에 지능적으로 대응합니다.
crawl: BFS, DFS 및 사이트맵 모드로 전체 사이트를 크롤링하며, robots.txt를 준수하고 자동으로 중복을 제거합니다.
extract: 페이지에서 표, 메타데이터, JSON-LD 및 사용자 지정 JSON 스키마의 구조화된 데이터를 추출합니다.
cache: 가져온 콘텐츠를 로컬 인덱스에 저장하고 키워드 및 시맨틱 검색을 지원합니다. 반복 검색은 밀리초 단위로 응답하며 오프라인에서도 사용할 수 있습니다.
find_similar: 키워드, 시맨틱 정보 및 실시간 웹페이지를 결합하여 대상 URL 또는 개념과 유사한 페이지를 찾습니다.
research: 복잡한 질문을 하위 쿼리로 자동 분해하고, 리소스를 병렬로 수집한 뒤 인용 출처가 포함된 구조화된 리서치 보고서를 작성합니다.
agent: ”계획→검색→가져오기→추출→합성”의 자율 수집 루프를 실행하며 단계별 로그와 시간 예산을 제공합니다.
diff + watch: 마지막 방문 이후 페이지의 변경 사항을 모니터링하고 변경 결과를 지정된 webhook으로 전송합니다.

환경 준비: 로컬에 Node.js 20 이상 버전이 설치되어 있는지 확인합니다.
한 번에 설치: npx wigolo init을 실행하여 브라우저 엔진과 모델을 자동으로 다운로드하고 Claude Code, Cursor 등의 Agent에 연결합니다.
상태 확인: npx wigolo health를 실행하여 검색, 브라우저 및 디바이스 측 모델이 정상적으로 작동하는지 확인합니다.
선택적 LLM 설정: research 또는 agent 기능이 필요한 경우 무료 Gemini API Key 또는 로컬 Ollama 모델을 설정합니다.
Agent에서 호출: Claude Code, Cursor 등 MCP를 지원하는 Agent에서 자연어로 검색, 가져오기 등의 도구를 직접 호출합니다.
CLI에서 직접 사용: 명령줄에서 npx wigolo search/fetch/crawl 등의 명령을 실행하여 작업을 수행합니다.
로컬 캐시 재사용: 모든 데이터는 ~/.wigolo/ 디렉터리에 자동으로 저장되며 오프라인 재사용과 시맨틱 검색을 지원합니다.

로컬 우선: 모든 검색, 가져오기 및 캐싱이 로컬 장치에서 이루어지므로 데이터가 기기 밖으로 나가지 않으며, 인터넷이 끊겨도 정상적으로 사용할 수 있습니다.
무료이자 진입 장벽 없음: 계정 가입이나 API Key가 필요 없고 모든 검색을 영구적으로 무료로 사용할 수 있으며, 한 번의 명령으로 주요 Agent에 연결할 수 있습니다.
완전히 설명 가능한 결과: 모든 검색 결과에 바이트 단위의 원문 발췌, 인용 ID 및 점수 구성 요소가 포함되어 품질을 한눈에 확인할 수 있습니다.
다중 엔진 병렬 검색: 18개의 검색 엔진을 동시에 조회하고 순위 융합과 디바이스 측 ML 재정렬을 통해 포괄적이고 정확한 결과를 제공합니다.
지능형 계층형 가져오기: 순수 HTTP에서 TLS 위장 및 헤드리스 브라우저로 자동 전환하며, 안티봇에 정직하게 대응하고 실패 시 명확하게 알려줍니다.
영구 로컬 캐시: 모든 콘텐츠를 로컬 혼합 인덱스(키워드+시맨틱 벡터)에 저장하여 반복 검색에 밀리초 단위로 응답합니다.

프로젝트 공식 웹사이트：https://knockoutez.github.io/wigolo/
GitHub 저장소：https://github.com/KnockOutEZ/wigolo

AI 코딩 지원: Agent가 코드를 작성할 때 최신 API 문서, 공식 튜토리얼 및 모범 사례를 자동으로 검색하므로 브라우저를 수동으로 전환할 필요가 없습니다.
기술 조사 및 경쟁사 분석: Agent가 여러 기술 블로그와 문서 사이트를 자율적으로 검색하고 가져온 뒤, 인용이 포함된 구조화된 리서치 보고서를 작성합니다.
전체 사이트 데이터 수집: 제품 카탈로그, 가격 정보, 논문 데이터베이스 또는 뉴스 사이트를 일괄 크롤링하고 표와 구조화된 데이터를 로컬로 추출합니다.
로컬 지식 베이스 구축: 자주 확인하는 문서와 웹페이지를 로컬에 캐시하여 개인 또는 팀이 오프라인에서 검색할 수 있는 지식 베이스를 구축합니다.
페이지 변경 모니터링: 경쟁사 공식 웹사이트, 문서 업데이트 페이지 또는 가격 페이지를 지속적으로 모니터링하고, 변경 시 webhook을 통해 자동으로 알림을 보냅니다.