MCP WebSearch Server

MCP Server for web search and advanced web scraping. Uses SearchAPI.io for Google Search and AI Mode.

Quick Start

Option 1: Stdio (npx)

Option 2: HTTP Server (Streamable HTTP)

Run as HTTP server:

Then configure MCP client with API key in URL or header:

Option A: API key in URL query parameter

Option B: API key in header

Option C: Server-side default key

The server implements MCP Streamable HTTP transport (spec 2025-03-26) with:

• Session management with Mcp-Session-Id headers

• SSE streaming for server-initiated messages

• Resumability support with Last-Event-ID

• Per-user API key support via query param or header

Get your API key at searchapi.io

Tools

Parameters

web_search

• query - Search query

• num_results - Number of results (1-20, default 10)

• page - Page number for pagination (1-10)

• time_period - Filter: last_hour, last_day, last_week, last_month, last_year

• site - Limit to specific site (e.g., "github.com")

ai_search

• query - Question or topic

• image_url - Optional image URL for visual questions

• location - Location for local queries

web_scrape

• url - URL to scrape

• selector - CSS selector (optional)

• extract_mode - text, markdown, or structured

• include_links - Include links in output

• max_length - Max content length (1000-50000)

get_links

• url - URL to extract links from

• filter - Text filter for URLs/anchors

scrape_multiple

• urls - Array of URLs (max 5)

• max_per_page - Max content per page (500-5000)

Deployment

PM2 (Production)

1. Edit ecosystem.config.js and set your SEARCHAPI_KEY

2. Run: npm run pm2:start

3. Check logs: npm run pm2:logs

Or manually:

Docker

Roadmap

• Add Serper.dev provider support

• Add SerpAPI provider support

• Provider auto-fallback

License

MIT