코딩 에이전트가 웹을 읽고 조사할 때 클라우드 비용과 키 설정을 덜어내는 로컬 도구
에이전트가 웹 검색과 크롤링을 위해 외부 API를 호출할 때마다 쌓이던 비용과 데이터 유출 걱정을 덜어냅니다. 모든 처리가 내 컴퓨터에서 일어나고, 결과에는 출처가 정확히 표기되어 있어 에이전트가 신뢰할 수 있는 근거를 바탕으로 답변을 만듭니다. 이는 AI 에이전트가 웹 정보를 수집하고 분석하는 과정을 로컬에서 처리하는 도구입니다.
에이전트가 웹과 대화하는 방식
이 도구는 AI 에이전트가 웹과 상호작용하는 모든 과정을 하나의 인터페이스로 묶어줍니다. 검색, 페이지 가져오기, 사이트 크롤링, 데이터 추출, 캐싱, 유사 페이지 찾기, 연구, 자율 수집 루프까지 10가지 도구를 제공합니다. 브라우저 엔진과 ML 모델이 내 기기에 설치되어 실행되므로, API 키가 필요 없고 클라우드 서버에 데이터가 전송되지 않습니다. 에이전트가 얼마나 많이 웹을 탐색하든 추가 비용이 발생하지 않으며, 모든 데이터는 ~/.wigolo/ 폴더 안에만 머물러 프라이버시를 보장합니다.
에이전트가 받는 결과의 형태
검색 결과는 단순한 링크 목록이 아니라, 에이전트가 즉시 활용할 수 있는 증거로 구성됩니다. 각 결과에는 원문에서 해당 구절이 위치한 바이트 오프셋까지 정확히 지정된 발췌문, 인용 ID, 그리고 점수 분해 정보가 포함됩니다. 약한 결과나 실패한 엔진은 자동으로 필터링되거나 명확히 표시되어, 에이전트가 어떤 근거 위에 서 있는지 항상 알 수 있습니다. 캐시된 데이터는 즉시 재사용되어 반복 조회 시 지연 없이 응답합니다.
설치와 에이전트 연결
Node.js 20 이상과 약 1.5GB의 디스크 공간이 필요합니다. npx wigolo init 명령어로 로컬 엔진을 설정하고, --agents 옵션을 추가하면 Claude Code, Cursor, Codex 등 주요 코딩 에이전트와의 연결을 한 번에 완료합니다. MCP 서버로 동작하여 기존 에이전트 환경에 자연스럽게 통합되며, REST API나 SDK를 통해 다른 프레임워크나 자체 호스팅 에이전트에도 연결할 수 있습니다. npx wigolo doctor 명령어로 시스템 상태를 언제든 점검할 수 있습니다.
유료 서비스와의 차이점
이 도구는 유료 웹 검색 API의 대안으로 설계되었지만, 단순 대체재가 아닌 에이전트 특화 웹 레이어입니다. 18개의 검색 엔진을 병렬로 조회하고 랭크 퓨전 및 ML 리랭킹을 적용해 정밀도를 높입니다. 봇 차단이 있는 페이지는 헤드리스 브라우저로 자동 전환하여 처리하며, 실패 시에도 원인을 명확히 보고합니다. 벤치마크 테스트에서 유료 서비스와 동일한 핵심 답변을 도출하면서도, 출처가 바이트 단위로 고정된 발췌문과 설명 가능한 점수 분해를 함께 제공합니다.
사용 전 확인 사항
현재 공개 베타 단계이며, 7,600개 이상의 테스트 스위트로 안정성을 검증받고 있습니다. research와 agent 도구에서 합성된 답변을 생성하려면 LLM 제공자 키가 필요하지만, 검색과 크롤링 등 핵심 기능은 키 없이도 작동합니다. 데이터센터 IP를 사용하는 경우 일부 사이트의 IP 평판 검사로 인해 접근이 제한될 수 있으므로, 이러한 환경에서는 프록시 설정을 고려해야 합니다. 상업적 목적으로 사용할 경우 AGPL-3.0 라이선스에 따라 상업 라이선스 취득이 필요합니다.
