wet-mcp 2.0.0

Open-source MCP Server thay thế Tavily - Web search, extract, crawl với SearXNG

WET - Web ExTract MCP Server

Open-source MCP Server replacing Tavily for web scraping & multimodal extraction

Zero-install experience: just uvx wet-mcp - automatically setups and manages SearXNG container.

Features

Feature	Description
Web Search	Search via SearXNG (metasearch: Google, Bing, DuckDuckGo, Brave)
Content Extract	Extract clean content (Markdown/Text/HTML)
Deep Crawl	Crawl multiple pages from a root URL with depth control
Site Map	Discover website URL structure
Media	List and download images, videos, audio files
Anti-bot	Stealth mode bypasses Cloudflare, Medium, LinkedIn, Twitter

Quick Start

Prerequisites

• Docker daemon running (for SearXNG)
• Python 3.13+ (or use uvx)

MCP Client Configuration

Claude Desktop / Cursor / Windsurf / Antigravity:

{
  "mcpServers": {
    "wet": {
      "command": "uvx",
      "args": ["wet-mcp"]
    }
  }
}

That's it! When the MCP client calls wet-mcp for the first time:

1. Automatically installs Playwright chromium
2. Automatically pulls SearXNG Docker image
3. Starts wet-searxng container
4. Runs the MCP server

Without uvx

pip install wet-mcp
wet-mcp

Tools

Tool	Actions	Description
web	search, extract, crawl, map	Web operations
media	list, download	Media discovery & download
help	-	Full documentation

Examples

# Search
{"action": "search", "query": "python web scraping", "max_results": 10}

# Extract content
{"action": "extract", "urls": ["https://example.com"]}

# Crawl with depth
{"action": "crawl", "urls": ["https://docs.python.org"], "depth": 2}

# Map site structure
{"action": "map", "urls": ["https://example.com"]}

# List media
{"action": "list", "url": "https://github.com/python/cpython"}

# Download media
{"action": "download", "media_urls": ["https://example.com/image.png"]}

Tech Stack

Component	Technology
Language	Python 3.13
MCP Framework	FastMCP
Web Search	SearXNG (auto-managed Docker)
Web Crawling	Crawl4AI
Docker Management	python-on-whales

How It Works

┌─────────────────────────────────────────────────────────┐
│                    MCP Client                           │
│            (Claude, Cursor, Windsurf)                   │
└─────────────────────┬───────────────────────────────────┘
                      │ MCP Protocol
                      ▼
┌─────────────────────────────────────────────────────────┐
│                   WET MCP Server                        │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────────┐   │
│  │   web    │  │  media   │  │        help          │   │
│  │ (search, │  │ (list,   │  │  (full documentation)│   │
│  │ extract, │  │ crawl,   │  └──────────────────────┘   │
│  │ crawl,   │  │ download)│                             │
│  │ map)     │  └────┬─────┘                             │
│  └────┬─────┘       │                                   │
│       │             │                                   │
│       ▼             ▼                                   │
│  ┌──────────┐  ┌──────────┐                             │
│  │ SearXNG  │  │ Crawl4AI │                             │
│  │ (Docker) │  │(Playwright)│                           │
│  └──────────┘  └──────────┘                             │
└─────────────────────────────────────────────────────────┘

Configuration

Environment variables:

Variable	Default	Description
WET_AUTO_DOCKER	true	Auto-manage SearXNG container
WET_SEARXNG_PORT	8080	SearXNG container port
SEARXNG_URL	http://localhost:8080	External SearXNG URL
LOG_LEVEL	INFO	Logging level

Container Management

# View SearXNG logs
docker logs wet-searxng

# Stop SearXNG
docker stop wet-searxng

# Remove container (will be recreated on next run)
docker rm wet-searxng

# Reset auto-setup (forces re-install Playwright)
rm ~/.wet-mcp/.setup-complete

License

MIT License