MCP server for web search and URL/resource loading. It works without API keys by default and stays local-first: search uses free providers, extracts useful content from URLs, and binary/media downloads only happen when explicitly requested.
MCP server: Multi-provider web search (DuckDuckGo, Bing, SearXNG) with automatic fallback, and URL content extraction — no API keys required.
2026-11-16
ดาว
—
เครื่องมือ
—
อัปไทม์
—
fetch_url
Features
search_web - multi-provider web search with automatic fallback across DuckDuckGo, Bing, and SearXNG.
fetch_url - universal URL/resource loader for HTML, PDF, text, Markdown, JSON, XML, CSV, media metadata, and supported site-specific URLs.
Clean normalized output with one content field plus metadata, pagination, links, media, attachments, and warnings.
Reddit thread extraction through Reddit JSON endpoints instead of brittle Reddit HTML scraping.
Long-resource pagination with max_length, start_index, and next_start_index.
Optional HTML link/media summaries.
Optional local download artifacts with download: true.
SSRF protection for localhost, private IPs, link-local ranges, IPv6 private ranges, and unsafe redirects.
Extracts readable article content, title, metadata, optional links, and optional media references
Text and Markdown
Returns text directly with pagination support
JSON
Pretty-prints JSON when format is json or text-like when requested
XML and CSV-like text
Returns as text/data content
PDF
Extracts text and PDF metadata
Images
Returns metadata by default; saves the file only with download: true
Audio and video
Returns metadata by default; saves the file only with download: true
Archives and binary files
Returns metadata by default; downloads only when explicitly requested; archives are not auto-extracted
Reddit threads
Uses Reddit JSON endpoints and can include comments with limits
Local Downloads
fetch_url does not download binary/media files to disk by default. This avoids surprise disk usage and persistent local copies of arbitrary web content.
Use download: true when you need the original file available to another tool:
The output uses resource_type: "site" and metadata.extractor: "reddit-thread".
Reddit public JSON can still rate-limit or return 403/429 depending on Reddit, subreddit rules, and request frequency. When that happens, retry later or reduce request frequency.
Providers
Provider
API Key Required
Notes
DuckDuckGo
No
Default, simple, no browser required
Bing
No
Uses Chrome/Chromium through Puppeteer
SearXNG
No
Best option for self-hosted high-volume usage
Environment Variables
Variable
Default
Description
DEFAULT_SEARCH_PROVIDER
duckduckgo
Default search provider: duckduckgo, bing, or searxng
SEARXNG_URL
http://localhost:8099
SearXNG instance URL
HTTP_TIMEOUT
15000
Request timeout in milliseconds
MAX_BYTES
20971520
Maximum fetched response/download size
MCP_COMPAT_MODE
unset
Set to legacy to simplify tools/list schemas for MCP clients with weak discovery parsers
SearXNG Setup
SearXNG is a free self-hosted meta-search engine.
Quick setup with Docker:
mkdir -p ~/docker/searxng
Create ~/docker/searxng/settings.yml with JSON enabled, then run the SearXNG container. The important setting is search.formats containing both html and json.
Example relevant setting:
search:
formats:
- html
- json
Then set:
export SEARXNG_URL="http://localhost:8099"
Chrome Setup for Bing Provider
OS
Command
Ubuntu/Debian
sudo apt install chromium-browser
Fedora
sudo dnf install chromium
Arch
sudo pacman -S chromium
macOS
brew install --cask google-chrome
Custom path:
export CHROME_PATH="/path/to/chrome"
MCP Discovery Compatibility
Some MCP clients have weak schema parsers and fail during discovery on array-valued JSON Schema nodes such as enum or required.
If discovery fails, set:
export MCP_COMPAT_MODE="legacy"
This only simplifies advertised tools/list schemas. Tool execution behavior stays the same.
URL Safety
fetch_url blocks unsafe targets before fetching and before following redirects.
IPv4-mapped IPv6 addresses that resolve to blocked IPv4 ranges
IPv6 loopback, unspecified, unique-local, multicast, and link-local ranges
redirects that resolve to blocked addresses
The HTTP transport resolves and validates addresses before connecting, then connects to the vetted address while preserving the original host/SNI for normal HTTPS behavior.
Repository Structure
src/server.ts - MCP server and tool schemas
src/providers/ - search providers
src/fetch/ - URL/resource loading pipeline
src/fetch/content/ - shared content helpers such as Markdown conversion and readability fallback
src/fetch/extractors/ - resource extractors for HTML, text/data, PDF, and media metadata
src/fetch/site-adapters/ - domain-specific extractors such as Reddit threads
src/utils/ - shared utilities
test/ - Node test runner tests
Troubleshooting
Issue
Solution
Chrome not found
Install Chrome/Chromium or set CHROME_PATH
SearXNG 403
Enable JSON API in settings.yml
Timeout
Increase HTTP_TIMEOUT or pass timeout_ms
MCP discovery error: 'list' object has no attribute 'get'
Set MCP_COMPAT_MODE=legacy
Reddit 429 or 403
Reddit rate limited or blocked the JSON endpoint; retry later or reduce request frequency
Download missing from output
Set download: true; downloads are disabled by default
Download rejected as too large
Increase max_download_bytes within the server cap or raise MAX_BYTES
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
@zhafron/mcp Web Search ต้องใช้ API key ไหม?
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
@zhafron/mcp Web Search ใช้ทรานสปอร์ตแบบใด?
@zhafron/mcp Web Search ทำงานแบบโลคัลผ่าน stdio
@zhafron/mcp Web Search ถูกตรวจสอบล่าสุดเมื่อใด?
ตรวจสอบล่าสุดเมื่อ 2026-11-16 MCP server: Multi-provider web search (DuckDuckGo, Bing, SearXNG) with automatic fallback, and URL content extraction — no API keys required.