{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo.png\" alt=\"Web Scout MCP Logo\" width=\"300\"/>\n</p>\n\n<h1 align=\"center\">Web Scout MCP Server</h1>\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@pinkpixel/web-scout-mcp\"><img src=\"https://img.shields.io/npm/v/@pinkpixel/web-scout-mcp.svg\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/pinkpixel-dev/web-scout-mcp/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"></a>\n  <a href=\"https://nodejs.org/en/\"><img src=\"https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg\" alt=\"Node.js Version\"></a>\n  <a href=\"https://smithery.ai/servers/pinkpixel-dev/web-scout-mcp\"><img alt=\"Smithery Badge\" src=\"https://smithery.ai/badge/pinkpixel-dev/web-scout-mcp\"></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://glama.ai/mcp/servers/pinkpixel-dev/web-scout-mcp\"><img src=\"https://glama.ai/mcp/servers/pinkpixel-dev/web-scout-mcp/badges/score.svg\" alt=\"web-scout-mcp MCP server\" /></a>\n  <a href=\"https://mseep.ai/app/pinkpixel-dev-web-scout-mcp\"><img src=\"https://mseep.net/pr/pinkpixel-dev-web-scout-mcp-badge.png\" alt=\"MseeP.ai Security Assessment Badge\" width=\"200\" /></a>\n</p>\n<p align=\"center\">\n  An MCP server for web search using DuckDuckGo and content extraction, with support for multiple URLs and memory optimizations.\n</p>\n\n## ✨ Features\n\n- 🔍 **DuckDuckGo Search**: Fast and privacy-focused web search capability\n- 📄 **Content Extraction**: Clean, readable text extraction from web pages\n- 🚀 **Parallel Processing**: Support for extracting content from multiple URLs simultaneously\n- 💾 **Memory Optimization**: Smart memory management to prevent application crashes\n- ⏱️ **Rate Limiting**: Intelligent request throttling to avoid API blocks\n- 🛡️ **Error Handling**: Robust error handling for reliable operation\n\n## 📦 Installation\n\n### Installing via Smithery\n\nTo install Web Scout for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@pinkpixel-dev/web-scout-mcp):\n\n```bash\nnpx -y @smithery/cli install @pinkpixel-dev/web-scout-mcp --client claude\n```\n\n### Global Installation\n\n```bash\nnpm install -g @pinkpixel/web-scout-mcp\n```\n\n### Local Installation\n\n```bash\nnpm install @pinkpixel/web-scout-mcp\n```\n\n## 🚀 Usage\n\n### Command Line\n\nAfter installing globally, run:\n\n```bash\nweb-scout-mcp\n```\n\n### With MCP Clients\n\nAdd this to your MCP client's `config.json` (Claude Desktop, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"web-scout\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@pinkpixel/web-scout-mcp@latest\"\n      ]\n    }\n  }\n}\n```\n\n### Environment Variables\n\nSet 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.\n\n## 🧰 Tools\n\nThe server provides the following MCP tools:\n\n### 🔍 DuckDuckGoWebSearch\n\nInitiates a web search query using the DuckDuckGo search engine and returns a well-structured list of findings.\n\n**Input:**\n- `query` (string): The search query string\n- `maxResults` (number, optional): Maximum number of results to return (default: 10)\n\n**Example:**\n```json\n{\n  \"query\": \"latest advancements in AI\",\n  \"maxResults\": 5\n}\n```\n\n**Output:**\nA formatted list of search results with titles, URLs, and snippets.\n\n### 📄 UrlContentExtractor\n\nFetches and extracts clean, readable content from web pages by removing unnecessary elements like scripts, styles, and navigation.\n\n**Input:**\n- `url`: Either a single URL string or an array of URL strings\n\n**Example (single URL):**\n```json\n{\n  \"url\": \"https://example.com/article\"\n}\n```\n\n**Example (multiple URLs):**\n```json\n{\n  \"url\": [\n    \"https://example.com/article1\",\n    \"https://example.com/article2\"\n  ]\n}\n```\n\n**Output:**\nExtracted text content from the specified URL(s).\n\n## 🛠️ Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/pinkpixel-dev/web-scout-mcp.git\ncd web-scout-mcp\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run\nnpm start\n```\n\n## 📚 Documentation\n\nFor more detailed information about the project, check out these resources:\n\n- [OVERVIEW.md](OVERVIEW.md) - Technical overview and architecture\n- [CONTRIBUTING.md](CONTRIBUTING.md) - Guidelines for contributors\n- [CHANGELOG.md](CHANGELOG.md) - Version history and changes\n\n## 📋 Requirements\n\n- Node.js >= 18.0.0\n- npm or yarn\n\n## 📄 License\n\nThis project is licensed under the [Apache 2.0 License](LICENSE).\n\n<p align=\"center\">\n  <sub>Made with ❤️ by <a href=\"https://pinkpixel.dev\">Pink Pixel</a></sub>\n  <br>\n  <sub>✨ Dream it, Pixel it ✨</sub>\n</p>\n",
  "bytes": 4722,
  "sha": "467fe6282fbc3035c88b47d105a1113fe7363bcefff942a04a5ee98f8b3ec3d4",
  "repo_slug": "pinkpixel-dev/web-scout-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_pinkpixel_dev_web_scout_mcp_45e442ae/readme"
}