Web Scout MCP Server

✨ Features

• 🔍 DuckDuckGo Search: Fast and privacy-focused web search capability

• 📄 Content Extraction: Clean, readable text extraction from web pages

• 🚀 Parallel Processing: Support for extracting content from multiple URLs simultaneously

• 💾 Memory Optimization: Smart memory management to prevent application crashes

• ⏱️ Rate Limiting: Intelligent request throttling to avoid API blocks

• 🛡️ Error Handling: Robust error handling for reliable operation

📦 Installation

Installing via Smithery

To install Web Scout for Claude Desktop automatically via Smithery:

Global Installation

Local Installation

🚀 Usage

Command Line

After installing globally, run:

With MCP Clients

Add this to your MCP client's config.json (Claude Desktop, Cursor, etc.):

Environment Variables

Set the WEB_SCOUT_DISABLE_AUTOSTART=1 environment variable when embedding the package and calling createServer() yourself. By default running the published entrypoint (for example node dist/index.js or npx @pinkpixel/web-scout-mcp) automatically bootstraps the stdio transport.

🧰 Tools

The server provides the following MCP tools:

🔍 DuckDuckGoWebSearch

Initiates a web search query using the DuckDuckGo search engine and returns a well-structured list of findings.

Input:

• query (string): The search query string

• maxResults (number, optional): Maximum number of results to return (default: 10)

Example:

Output: A formatted list of search results with titles, URLs, and snippets.

📄 UrlContentExtractor

Fetches and extracts clean, readable content from web pages by removing unnecessary elements like scripts, styles, and navigation.

Input:

• url: Either a single URL string or an array of URL strings

Example (single URL):

Example (multiple URLs):

Output: Extracted text content from the specified URL(s).

🛠️ Development

📚 Documentation

For more detailed information about the project, check out these resources:

• OVERVIEW.md - Technical overview and architecture

• CONTRIBUTING.md - Guidelines for contributors

• CHANGELOG.md - Version history and changes

📋 Requirements

• Node.js >= 18.0.0

• npm or yarn

📄 License

This project is licensed under the Apache 2.0 License.