web-forager

library3.0.1pypypi✓ verified 85d ago

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.

llm-agents http-networking ai-ml

pip install web-forager

github ↗package ↗

INSTALL

IMPORT

SIG · WEB-FORAGER

web-forager

llm-agentspythonv3.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

web_forager

✓ from web_forager import *

✗ from duckduckgo_mcp import *

Module renamed in v3.0.0.

mcp_server

✓ from web_forager.mcp_server import mcp

✗ from duckduckgo_mcp.mcp_server import mcp

Path changed due to package rename.

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()

web-forager --version

Debug

Known issues

breakingPackage 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.

affects: >=3.0.0

gotchaDuckDuckGo 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.

affects: all

deprecatedtech-radar skill replaced by tech-advisor in v3.0.0.

fix

Use tech-advisor skill instead.

affects: <3.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'web_forager'

Package not installed or wrong Python environment.

fix

Run: pip install web-forager

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

Old import path from renamed package.

fix

Update import: from web_forager.mcp_server import mcp

ddgs.exceptions.DDGException: 402 Payment Required

DuckDuckGo rate limiting; too many requests.

fix

Reduce request frequency or implement exponential backoff.

Upgrade

Version history

3.0.1latest on PyPI · released Mar 5, 2026

Audit

Dependencies

duckduckgo-mcpoptionalRenamed from duckduckgo-mcp to web-forager in v3.0.0; old package may be confused.

Agent activity

51 hits · last 30 days

node

Perplexity

OpenAI (training)

Resources

githubhttps://github.com/CyranoB/web-forager ↗

packagehttps://pypi.org/project/web-forager/ ↗