Web Forager

3.0.1 verified Sat May 09 auth: no python

A search-and-fetch toolkit for AI agents, providing an MCP server and standalone Agent Skills powered by DuckDuckGo and Jina Reader. Version 3.0.1, actively maintained.

pip install web-forager

Common errors

error ModuleNotFoundError: No module named 'web_forager' ↓

cause Package not installed or wrong Python environment.

fix

Run: pip install web-forager

error ImportError: cannot import name 'mcp' from 'duckduckgo_mcp' ↓

cause Old import path from renamed package.

fix

Update import: from web_forager.mcp_server import mcp

error ddgs.exceptions.DDGException: 402 Payment Required ↓

cause DuckDuckGo rate limiting; too many requests.

fix

Reduce request frequency or implement exponential backoff.

Warnings

breaking Package renamed from duckduckgo-mcp to web-forager; all imports and CLI commands changed. ↓

fix Uninstall old package: pip uninstall duckduckgo-mcp. Install new: pip install web-forager. Update imports and CLI usage.

gotcha DuckDuckGo may rate-limit requests; the library uses ddgs 9.10.0 to mitigate, but heavy usage can still be blocked. ↓

fix Add delays between requests or use a different search backend.

deprecated tech-radar skill replaced by tech-advisor in v3.0.0. ↓

fix Use tech-advisor skill instead.

Imports

web_forager

wrong

from duckduckgo_mcp import *

correct

from web_forager import *

Module renamed in v3.0.0.

mcp_server

wrong

from duckduckgo_mcp.mcp_server import mcp

correct

from web_forager.mcp_server import mcp

Path changed due to package rename.

Quickstart

Launch the MCP server that provides DuckDuckGo search and Jina Reader fetch tools.

from web_forager.mcp_server import mcp
import os
# Set API key if needed
os.environ['JINA_API_KEY'] = 'your-key'  # optional
mcp.run()