Skip to main content

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

Project description

WET - Web ExTract MCP Server

PyPI version License: MIT

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

Project details


Release history Release notifications | RSS feed

This version

2.1.3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wet_mcp-2.1.3.tar.gz (14.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wet_mcp-2.1.3-py3-none-any.whl (19.5 kB view details)

Uploaded Python 3

File details

Details for the file wet_mcp-2.1.3.tar.gz.

File metadata

  • Download URL: wet_mcp-2.1.3.tar.gz
  • Upload date:
  • Size: 14.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wet_mcp-2.1.3.tar.gz
Algorithm Hash digest
SHA256 bffa4552f28b6cccb255c692c5fedb349cb9be58202c8aed60b986b2f4002d34
MD5 59eb4699153114f89d8c6585f2d9f7b1
BLAKE2b-256 8eee31f32b98f91cf3f39bddfe3ddba19280e1d107d0ca3b19a96b84fcc1699c

See more details on using hashes here.

File details

Details for the file wet_mcp-2.1.3-py3-none-any.whl.

File metadata

  • Download URL: wet_mcp-2.1.3-py3-none-any.whl
  • Upload date:
  • Size: 19.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wet_mcp-2.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b8d5fa60944657e1d20d34bfb90418f63f7353192533fbede54affbf70dd42c6
MD5 48fef076ff9132a97be923c04500972e
BLAKE2b-256 f4c9e73d3c000b639d93430a360faeebf92b19a90635b84b70f3a05e82e9b5aa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page