Google, DuckDuckGo, Bing Search results by the headless browser.

특징

• Multi-Engine Search: Google, DuckDuckGo 및 엔진이 차단되거나 아무것도 반환 할 때 자동적인 fallback으로 빙
• Structured 결과: 제목, URL, 도메인, 스니펫, 그리고 순위 - 리디렉션 URL은 자신의 실제 목적지에 갇혀 -Web Page Content: 모든 웹페이지에서 텍스트 콘텐츠를 Fetch 및 추출 -Pluggable Browser Backends: Selenium + headless Chrome (기본값) 또는 환경 변수를 통해 선택된 경량 Obscura headless 브라우저
• MCP 호환: Claude 데스크톱 및 기타 MCP 클라이언트와 완벽하게 호환

사용 가능한 도구

search_web

다중 엔진 (Google → DuckDuckGo → Bing)을 통해 웹을 자동 내리고 구조화 된 결과를 반환합니다.

** 모수: **

• query (문자): 검색 쿼리 문자열
• max_results (int, Selection): (기본값: 10, max: 100)
• include_snippets (bool, 옵션): text snippets (기본값: true)를 포함하든

리턴스:

• 검색 결과 목록 :

Web Search MCP

A Model Context Protocol (MCP) server that provides web search functionality by scraping Google, DuckDuckGo, and Bing search results through a headless browser.

Features

• Multi-Engine Search: Searches Google, DuckDuckGo, and Bing with automatic fallback when an engine is blocked or returns nothing
• Structured Results: Titles, URLs, domains, snippets, and rankings — with redirect URLs unwrapped to their real destinations
• Web Page Content: Fetch and extract text content from any webpage
• Pluggable Browser Backends: Selenium + headless Chrome (default) or the lightweight Obscura headless browser, selected via an environment variable
• MCP Compatible: Fully compatible with Claude Desktop and other MCP clients

Tools Available

search_web

Search the web across multiple engines (Google → DuckDuckGo → Bing) with automatic fallback and return structured results.

Parameters:

• query (string): The search query string
• max_results (int, optional): Maximum number of results to return (default: 10, max: 100)
• include_snippets (bool, optional): Whether to include text snippets (default: true)

Returns:

• List of search results with:
  • title: Page title
  • url: Full URL (redirect wrappers resolved to the real destination)
  • domain: Domain name
  • snippet: Text snippet (if enabled)
  • rank: Search result ranking
  • source_engine: Which engine produced the result (google, duckduckgo, or bing)

get_webpage_content

Fetch and return the text content of a webpage.

Parameters:

• url (string): The URL of the webpage to fetch
• max_length (int, optional): Maximum content length (default: 5000, max: 20000)

Returns:

• Dictionary with:
  • url: The requested URL
  • title: Page title
  • content: Extracted text content
  • length: Content length in characters

get_search_engine_status

Report the active browser backend and the availability of each search engine.

Returns:

• Dictionary with a backend key (selenium or obscura) plus each engine name mapped to available or blocked.

reset_search_engines

Clear the list of engines marked as blocked during the session (useful if an engine recovers).

Returns:

• A status message string.

Installation

1. Install dependencies:

   # Using uv (recommended)
   uv sync
   
   # Or using pip
   pip install -e .
   

2. Install a browser backend (pick one):

   • Selenium (default) — requires Chrome:
     • On macOS: brew install --cask google-chrome