🔍 web-search-plus-mcp

지능형 자동 라우팅 기능을 갖춘 다중 제공업체 웹 검색 및 추출 MCP 서버.

web-search-plus-mcp는 Web Search Plus를 독립형 MCP로 패키징한 것입니다. Claude Desktop, NanoBot, Cursor 및 기타 MCP 호환 호스트가 Hermes/OpenClaw Web Search Plus 도구에서 사용하는 것과 동일한 Python 라우팅 엔진 제품군에 액세스할 수 있도록 합니다.

✨ 주요 기능

• 10개의 검색 제공업체 — Serper, Brave, Tavily, Exa, Querit, Linkup, Firecrawl, Perplexity, You.com, SearXNG

• 5개의 추출 제공업체 — Firecrawl, Linkup, Tavily, Exa, You.com

• 지능형 자동 라우팅 — 쿼리 의도를 점수화하여 자동으로 제공업체 선택

• 품질 보고서 — 선택적 라우팅/결과 진단

• 연구 모드 — 시간 제한을 두고 다중 제공업체 검색 + 상위 소스 추출을 선택적으로 수행

• 설치 없는 실행 — uvx web-search-plus-mcp

• MCP 네이티브 — web_search 및 web_extract를 노출하는 stdio 서버

Related MCP server: OneSearch MCP Server

🚀 빠른 시작

# Run instantly with uvx
uvx web-search-plus-mcp

# Or install globally
pip install web-search-plus-mcp
web-search-plus-mcp

검색을 위해서는 최소 하나의 제공업체 자격 증명이 필요합니다. 추출을 위해서는 추출이 가능한 최소 하나의 제공업체 키가 필요합니다.

⚙️ Claude Desktop 구성

macOS의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json에, Windows의 경우 %APPDATA%\Claude\claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "web-search-plus": {
      "command": "uvx",
      "args": ["web-search-plus-mcp"],
      "env": {
        "LINKUP_API_KEY": "your_linkup_key",
        "TAVILY_API_KEY": "your_tavily_key",
        "EXA_API_KEY": "your_exa_key",
        "FIRECRAWL_API_KEY": "your_firecrawl_key",
        "BRAVE_API_KEY": "your_brave_key",
        "SERPER_API_KEY": "your_serper_key",
        "QUERIT_API_KEY": "your_querit_key",
        "PERPLEXITY_API_KEY": "your_perplexity_key",
        "YOU_API_KEY": "your_you_key",
        "SEARXNG_INSTANCE_URL": "https://your-searxng-instance.example.com"
      }
    }
  }
}

패키지/프로젝트 옆에 동일한 변수가 포함된 .env 파일을 배치할 수도 있습니다.

🔎 검색 제공업체

• Serper — Google 스타일의 사실, 뉴스, 쇼핑, 지역 쿼리

• Brave — 범용 독립 웹 인덱스

• Tavily — 연구 및 분석

• Exa — 의미론적 발견, 유사성, 심층/심층 추론 합성

• Querit — 다국어, 실시간 AI 검색

• Linkup — 소스 기반 근거/인용

• Firecrawl — 웹 검색 및 스크랩 준비 콘텐츠

• Perplexity — 직접적인 합성 답변

• You.com — LLM 준비 실시간 스니펫

• SearXNG — 개인정보 보호 우선 자체 호스팅 메타 검색

📄 추출 제공업체

• Linkup — 깔끔한 마크다운과 저렴한 비용으로 첫 번째로 권장되는 선택

• Firecrawl — 강력한 스크랩 대체 수단, JS가 많거나 차단된 페이지에 유용

• Tavily — 추출/콘텐츠 API

• Exa — 콘텐츠 API

• You.com — 사용 가능한 경우 LLM 준비 스니펫/콘텐츠

🛠 MCP 도구 참조

web_search

매개변수:

• query — 필수 검색 쿼리

• provider — auto, serper, brave, tavily, exa, querit, linkup, firecrawl, perplexity, you, searxng

• count — 반환할 결과 수, 기본값 5, 최대 20

• depth — Exa 깊이: normal, deep, deep-reasoning

• time_range — hour, day, week, month, year

• include_domains / exclude_domains — 도메인 허용/차단 목록

• mode — normal 또는 research

• quality_report — 라우팅/결과 진단 포함

• research_time_budget — 연구 모드를 위한 최선의 시간 제한(벽시계 시간)

예시 MCP 인수:

{
  "query": "latest Hermes Agent release",
  "provider": "linkup",
  "count": 5,
  "quality_report": true
}

web_extract

매개변수:

• urls — 필수 URL 목록

• provider — auto, firecrawl, linkup, tavily, exa, you

• format — markdown 또는 html

• include_images — 지원되는 경우 이미지 메타데이터 포함

• include_raw_html — 지원되는 경우 원시 HTML 포함

• render_js — 지원되는 경우 추출 전 JavaScript 렌더링

예시 MCP 인수:

{
  "urls": ["https://example.com"],
  "provider": "linkup",
  "format": "markdown"
}

🧠 자동 라우팅 예시

• iPhone 16 Pro price → Serper/Brave 쇼핑 스타일 검색

• how does TCP/IP work → Tavily 연구 스타일 검색

• latest multilingual EV market updates → Querit/Linkup 실시간/소스 기반 검색

• companies like Stripe → Exa 발견 검색

• what is quantum computing → Perplexity/You.com 직접 답변 스타일 검색

• privacy focused search results → 구성된 경우 SearXNG

크레딧

원래 OpenClaw/Clawhub용으로 개발되고 나중에 hermes-web-search-plus로 Hermes에 포팅된 Web Search Plus 라우팅 로직을 기반으로 구축되었습니다.

라이선스

MIT © 2026 robbyczgw-cla