Web Researcher MCP

웹 검색 및 출처 제한

AI는 사용자가 지정한 검색 렌즈(PubMed, SEC.gov, arXiv 등) 내에서만 웹을 검색하며, 블로그나 SEO 스팸과 같은 신뢰할 수 없는 출처는 자동으로 제외됩니다. DuckDuckGo가 기본 제공되며, Google, Brave, Serper 등 다양한 검색 제공자를 연동할 수 있습니다.

전체 문서 읽기

검색 결과에서 단순히 스니펫이 아닌 전체 웹 페이지, PDF, Word 문서, 심지어 YouTube 트랜스크립트와 Hacker News 스레드까지 읽어들여 분석할 수 있습니다. 이는 인용의 맥락을 정확히 파악하는 데 필수적입니다.

실시간 인용 검증

모든 검색 결과에 대해 Crossref, Semantic Scholar 등을 통해 DOI 존재 여부를 확인하고, 작동하는 링크와 함께 APA/MLA 형식의 정식 인용을 생성합니다. 허위 인용은 절대 생성되지 않습니다.

다단계 심층 연구

AI는 이전 검색 결과를 기억하고 이를 바탕으로 후속 검색을 수행하여 복잡한 주제에 대한 구조화된 조사를 할 수 있습니다. 예를 들어, 기업에 대한 경쟁 분석 시 뉴스, 특허, 웹 페이지를 순차적으로 탐색할 수 있습니다.

Windows 사용자를 위한 설치 방법

Windows에서는 PowerShell을 통해 간단히 설치할 수 있습니다. 관리자 권한이 필요하지 않으며, 설치 시 자동으로 PATH에 등록되고 Claude Code가 있다면 연동도 자동으로 수행됩니다.

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

또는 WinGet, Scoop, Chocolatey 패키지 관리자를 통해서도 설치할 수 있습니다.

winget install zoharbabin.web-researcher-mcp

scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket && scoop install web-researcher-mcp

choco install web-researcher-mcp

설치 후 Claude Code 연동 방법

설치 스크립트가 자동으로 Claude Code에 등록하지만, 수동으로 연동하려면 다음 명령을 실행합니다.

claude mcp add --scope user web-researcher -- uvx web-researcher-mcp

기본 사용법/명령어

설치 후, 지원하는 AI 어시스턴트(Claude, Cursor 등)에서 자연어로 연구를 요청하면 도구가 자동으로 작동합니다. 예를 들어, “최신 CRISPR 오프타겟 효과에 대한 논문을 찾아주고 인용을 검증해줘”라고 말하면, 지정된 학술 렌즈 내에서 검색 후 전체 논문을 읽고 검증된 인용을 반환합니다.

고급 사용자는 환경 변수를 통해 검색 제공자를 변경할 수 있습니다. 예를 들어 Brave 검색을 사용하려면 다음과 같이 설정합니다.

set SEARCH_PROVIDER=brave
set BRAVE_API_KEY=your_api_key_here

설정 후에는 AI 어시스턴트를 재시작하면 변경 사항이 적용됩니다.

이런 경우에 유용합니다

법률 전문가는 미국 연방 법원 판결을 검색할 때, 허위 사례 인용으로 인한 배상 위험을 방지하기 위해 CourtListener 기반의 legal_search 도구를 활용할 수 있습니다. 모든 결과는 실제 존재하는 사건에 대한 검증된 링크와 함께 제공됩니다.

의학 연구자는 PubMed 기반의 biomedical 렌즈를 활성화하여 임상 시험 데이터나 유전자-질환 연관성을 검색할 때, 건강 블로그나 사전 검증되지 않은 출처에서의 오류를 차단할 수 있습니다. 이는 환자 치료 결정에 직접적인 영향을 줄 수 있는 연구에서 필수적입니다.

기자는 정부 기록이나 SEC 공시를 검색할 때, Perplexity나 ChatGPT가 생성하는 가짜 DOI나 요약 대신, 원본 문서 전체를 읽고 검증된 인용을 얻을 수 있어 기사 작성 시 신뢰도를 높일 수 있습니다.

지원 환경·시스템 요구사항

이 도구는 Windows 10 이상에서 실행 가능하며, 설치를 위해 PowerShell 5.1 이상이 필요합니다. 별도의 개발 도구(Go 컴파일러 등)는 필요하지 않으며, 모든 설치 방법은 사전 빌드된 바이너리를 다운로드하여 PATH에 등록하는 방식으로 동작합니다. 인터넷 연결이 필수적이며, 일부 고급 기능(Google 검색 등)은 API 키가 필요할 수 있지만, 기본 DuckDuckGo 제공자는 키 없이도 즉시 사용 가능합니다.

최신 버전·업데이트

현재 버전은 1.49.3이며, 업데이트 내역은 공식 GitHub 저장소의リリース 페이지에서 확인할 수 있습니다. 자동 업데이트는 지원되지 않으나, Winget, Scoop, Chocolatey 등을 통해 최신 버전으로 재설치할 수 있습니다.

제한 사항·확인 사항

일부 고급 도구는 특정 환경 변수가 설정되어야만 활성화됩니다. 예를 들어, SEC 공시 검색(filing_search)은 EDGAR_CONTACT_EMAIL 변수가 필요하며, 지역 검색(local_search)은 BRAVE_API_KEY가 필요합니다. 이러한 변수가 설정되지 않은 경우 해당 도구는 자동으로 비활성화되거나 웹 검색으로 폴백됩니다.

인증이 필요한 일부 제공자(Google PSE, Serper 등)는 무료 사용량 제한이 있으며, 이를 초과할 경우 일시적으로 검색이 차단될 수 있습니다. 사용자는 다중 제공자 라우팅을 구성하여 하나의 제공자가 실패할 경우 자동으로 다른 제공자로 전환하도록 설정할 수 있습니다.