Web Researcher MCP

1) Web Researcher MCP 설치 (가장 빠른 방법: uvx): uv를 설치(일회성)한 다음 uvx를 통해 MCP 서버를 실행합니다. macOS/Linux: - curl -LsSf https://astral.sh/uv/install.sh | sh 그런 다음: - claude mcp add --scope user web-researcher -- uvx web-researcher-mcp 이렇게 하면 OS에 맞는 올바른 사전 빌드된 바이너리를 가져와 실행합니다(Go 툴체인 필요 없음). 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

2) 대체 설치 (하나 선택): macOS (Homebrew): - brew install zoharbabin/tap/web-researcher-mcp - claude mcp add --scope user web-researcher -- web-researcher-mcp macOS/Linux (curl 설치 프로그램): - curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh Windows (PowerShell 설치 프로그램): - powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex" 다른 옵션: - winget install zoharbabin.web-researcher-mcp - scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket && scoop install web-researcher-mcp - brew install --cask zoharbabin/tap/web-researcher-mcp - go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest - docker run -i --rm -e GOOGLE_CUSTOM_SEARCH_API_KEY=YOUR_KEY -e GOOGLE_CUSTOM_SEARCH_ID=YOUR_CX docker.io/zoharbabin/web-researcher-mcp:latest 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

3) MCP 클라이언트에 연결 (일반 JSON 구성): 앱이 Claude Code의 CLI 흐름이 아닌 경우, 클라이언트 구성에 MCP 서버 항목을 추가합니다. 예시 (Google PSE): { "mcpServers": { "web-researcher": { "command": "web-researcher-mcp", "env": { "SEARCH_PROVIDER": "google", "GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_GOOGLE_API_KEY", "GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ENGINE_ID" } } } } 예시 (Brave): { "mcpServers": { "web-researcher": { "command": "web-researcher-mcp", "env": { "SEARCH_PROVIDER": "brave", "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY" } } } } 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

4) 구성 없이 실행 (DuckDuckGo 대체): SEARCH_PROVIDER 또는 API 키를 설정하지 않아도 Web Researcher MCP는 DuckDuckGo를 내장 대체(API 키 필요 없음)로 사용하여 즉시 작동합니다. 이는 공급자 키를 추가하기 전에 설정을 확인하는 데 유용합니다. 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

5) (권장) 검색 공급자 키를 추가하여 품질을 향상하고 더 많은 기능을 잠금 해제: SEARCH_PROVIDER 및 일치하는 키를 설정합니다. 지원되는 공급자에는 DuckDuckGo(키 없음), Google PSE, Brave, Serper, SearchAPI.io, SearXNG, Tavily, Exa 및 Hacker News가 포함됩니다. 환경 변수 예시: - SEARCH_PROVIDER=brave - BRAVE_API_KEY=... 또는 Google PSE: - SEARCH_PROVIDER=google - GOOGLE_CUSTOM_SEARCH_API_KEY=... - GOOGLE_CUSTOM_SEARCH_ID=... 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

6) (선택 사항) 다중 공급자 페일오버 구성: 다운타임/속도 제한을 피하려면 여러 공급자를 구성하여 서버가 자동으로 대체되도록 합니다. 예시: - SEARCH_ROUTING=brave,google,serper - BRAVE_API_KEY=... - GOOGLE_CUSTOM_SEARCH_API_KEY=... - GOOGLE_CUSTOM_SEARCH_ID=... - SERPER_API_KEY=... 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

7) '검색 렌즈'를 사용하여 결과를 신뢰할 수 있는 소스로 제한: 더 높은 신뢰도와 스팸 감소를 원할 때 내장된 렌즈(예: 의료, 법률, 학술, 뉴스)를 사용하여 검색이 선별된 도메인으로 제한되도록 합니다. AI 클라이언트에 대한 프롬프트 예시: - "임상 렌즈를 사용하여 SGLT2 억제제에 대한 최근 연구 결과를 검색해줘." 도메인 허용 목록이 있는 JSON 파일을 lenses/ 아래에 추가하여 사용자 지정 렌즈를 만들 수도 있습니다. 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

8) AI에게 핵심 도구 사용 요청 (일반적인 워크플로우): 연결되면 AI는 다음과 같은 도구를 호출할 수 있습니다: - web_search: 웹 검색 (선택적으로 렌즈 사용) - scrape_page: URL 전체 읽기 (웹 페이지, PDF, DOCX, PPTX, YouTube 스크립트) - search_and_scrape: 검색 후 상위 결과 자동 읽기 - news_search / image_search: 공급자가 지원하는 경우 - academic_search / patent_search / legal_search / filing_search / econ_search / clinical_search: 전문 데이터베이스 - verify_citation / audit_bibliography / format_bibliography: 인용 워크플로우 - sequential_search: 다단계 심층 연구 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

9) 반복 가능한 연구를 위해 안내된 프롬프트 템플릿 사용: 구조화된 워크플로우를 실행하기 위해 내장된 프롬프트 템플릿(클라이언트가 프롬프트 선택을 지원하는 경우)을 사용합니다: - comprehensive-research - fact-check - competitive-analysis - literature-review 이러한 템플릿은 모든 지침을 지정할 필요 없이 다단계 연구를 안내합니다. 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

10) 일반적인 문제 해결 (빠른 수정): 도구가 "API 키" 오류로 실패하는 경우: MCP 클라이언트 구성 env 블록에 키를 설정합니다(셸 프로필에만 설정하지 마십시오). 페이지가 비어 있는 경우: JavaScript가 많은 사이트에는 Chromium이 필요합니다. 바이너리는 첫 사용 시 Chromium을 자동으로 다운로드합니다(~200MB). CHROME_PATH를 기존 Chrome 설치로 설정할 수 있습니다. Docker 이미지에는 Chromium이 포함되어 있습니다. 업그레이드 후 캐시가 오래된 경우: 캐시 디렉터리를 삭제하거나(예: macOS의 ~/Library/Caches/web-researcher-mcp/) CACHE_DIR을 설정합니다. 공급자 속도 제한(429)에 도달하는 경우: 공급자를 전환하거나 페일오버를 위해 SEARCH_ROUTING을 구성합니다. 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

11) (팀) HTTP 모드에서 실행하고 클라이언트를 공유 엔드포인트에 연결: 공유/팀 설정을 위해 서버를 HTTP 서비스로 실행하고 MCP 클라이언트를 http://localhost:3000/mcp/에 연결합니다. 예시: - PORT=3000 OAUTH_ISSUER_URL=https://auth.example.com OAUTH_AUDIENCE=https://api.example.com ./web-researcher-mcp Docker Compose 예시: services: web-researcher: image: zoharbabin/web-researcher-mcp ports: - "3000:3000" environment: PORT: "3000" SEARCH_PROVIDER: brave BRAVE_API_KEY: ${BRAVE_API_KEY} 출처: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt