LLM Wiki

wigolo: API 키 없이 로컬에서 동작하는 AI 에이전트용 웹 검색 MCP 서버

Properties2
descriptionPyTorchKR 9bow 게시글의 핵심 내용과 실무적 의미를 원문에 근거해 정리한다.
tagsai-models, open-source, research

5 min read

출처

개요

wigolo는 API 키나 쿼리별 과금 없이 로컬에서 실행할 수 있도록 설계된 AI 에이전트용 웹 검색·수집 MCP 서버입니다. 검색, 페이지 가져오기, 크롤링, 구조화 추출, 캐시, 유사 문서 탐색, 리서치, 자율 수집, 변경 감지 등을 하나의 인터페이스로 제공합니다. 기본 검색·수집 기능은 로컬 엔진과 온디바이스 모델을 사용하며, 데이터와 캐시는 ~/.wigolo/에 저장됩니다. research·agent처럼 자연어 보고서를 생성하는 기능은 외부 또는 로컬 LLM을 선택적으로 사용할 수 있습니다. MCP 외에도 CLI, REST API, TypeScript·Python SDK와 여러 에이전트 프레임워크 연동을 지원하며, 원문 작성 시점에는 공개 베타로 소개되었습니다.

핵심 포인트

  • search는 18개 검색 엔진을 활용한 멀티 엔진 검색, 순위 융합, ML 리랭킹을 지원하고 결과별 점수와 엔진 합의 정보를 반환합니다.
  • fetch·crawl·extract를 통해 일반 웹 페이지, PDF, SPA, 안티봇 대응 페이지와 사이트 전체를 다룰 수 있으며, robots.txt 준수와 도메인별 요청 속도 제한을 포함합니다.
  • 검색 결과에는 원문의 위치에 고정된 발췌문, citation_id, 의미·어휘·엔진 합의 기반 점수 등이 포함되어 에이전트가 근거를 확인할 수 있습니다.
  • 실패한 엔진, 오래된 캐시, 낮은 품질 결과, 봇 차단 페이지 등도 숨기지 않고 상태 라벨로 표시합니다. 예를 들어 차단 페이지는 콘텐츠로 오인하지 않고 blocked_by_challenge로 보고합니다.
  • 검색·가져오기·크롤링·추출·캐시·유사 문서 탐색은 API 키 없이 사용할 수 있으며, LLM을 사용하지 않으면 구조화된 브리프와 근거를 반환합니다.
  • npx wigolo init으로 설치하고 Claude Code, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Zed 등과 MCP로 연결할 수 있습니다. REST 서버는 wigolo serve로 실행합니다.
  • GNU AGPL-3.0 라이선스이므로 소프트웨어를 수정해 배포하거나 네트워크 서비스 형태로 외부 제공할 때 라이선스 의무를 확인해야 합니다.

왜 중요한가

AI 에이전트는 한 번의 검색보다 여러 질의와 후속 페이지 수집을 반복하는 경우가 많아 외부 웹 검색 API의 키 관리와 사용량 비용이 부담이 될 수 있습니다. wigolo는 이 작업을 로컬 중심으로 처리하고, 검색 결과의 근거·점수·실패 상태를 함께 반환하는 방식을 제안합니다. 따라서 비용과 데이터 외부 전송을 줄이고 싶은 개인 개발 환경이나 자체 호스팅 에이전트에서 검토할 수 있지만, 실제 검색 품질·사이트별 차단 대응·리소스 요구사항은 사용 환경에서 확인할 필요가 있습니다.

후속으로 볼 링크와 키워드

관련 위키

원문 보존 위치

원문 전체는 2026-07-25-pytorchkr-topic-11374-wigolo-api-ai-mcp에 source_url 및 HTML 원문과 함께 저장되어 있습니다.

백링크