# Private Web Search

Private Web Search — an MCP server that provides DuckDuckGo search and webpage fetching. Long result URLs are replaced with short ref:// tokens to save context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: nickclyde
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nickclyde/duckduckgo-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/private-web-search

## What it does

The server gives the agent a `search` tool (DuckDuckGo queries) and `fetch_content` (page download and parsing). Search results are formatted for LLMs. Long URLs in results are replaced with `ref://<id>` tokens that `fetch_content` accepts directly, keeping context lean.

Built-in rate limits: 30 searches and 20 page fetches per minute (configurable via `DDG_SEARCH_RPM` and `DDG_FETCH_RPM`). Parsed pages are cached for 300 seconds (`DDG_CACHE_TTL`). The server will not start without `uvx` installed.

SafeSearch (`STRICT`, `MODERATE`, `OFF`) and region (`us-en`, `cn-zh`, `jp-ja`) are set via environment variables. Behind a corporate TLS-intercepting proxy, point `DDG_CA_CERTS` at the proxy's CA bundle.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- search the web via DuckDuckGo from an agent
- fetch and parse a webpage into text or markdown
- replace long URLs with short tokens to save context
- limit request rates to the search engine and sites
- filter search results by region and SafeSearch level

## Example prompts
- Find the latest news about Rust 1.85
- Fetch the content of `ref://abc123` and extract the main text
- Search for MCP server documentation for Claude

## Similar
- [DuckDuckGo & Felo AI Search](https://affpapa.org/en/nevibecode/mcp/duckduckgo-felo-ai-search.md) — MCP server · 12697 installs
- [pinkpixel-dev-web-scout-mcp](https://affpapa.org/en/nevibecode/mcp/pinkpixel-dev-web-scout-mcp.md) — MCP server · ★ 152 repo stars
- [Keenable Web Search](https://affpapa.org/en/nevibecode/mcp/keenable-web-search.md) — MCP server · 2498 installs
- [SERPdive Web Search](https://affpapa.org/en/nevibecode/mcp/serpdive-web-search.md) — MCP server
- [MCP Retrieval](https://affpapa.org/en/nevibecode/mcp/mcp-retrieval.md) — MCP server · ★ 23 repo stars
- [web-search](https://affpapa.org/en/nevibecode/skills/web-search.md) — skill · 130800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
