DDGSCAUTION
A metasearch library that aggregates results from diverse web search services
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://github.com/deedy5/ddgs/releases) [](https://pypi.org/project/ddgs)
A metasearch library that aggregates results from diverse web search services.
Table of Contents
- Install
- CLI version
- API Server
- MCP Server
- Engines
- DDGS class
- 1. text()
- 2. images()
- 3. videos()
- 4. news()
- 5. books()
- 6. extract()
- Disclaimer
Install
pip install -U ddgs # Base install pip install -U ddgs[api] # API server (FastAPI) pip install -U ddgs[mcp] # MCP server (stdio)
CLI version
ddgs - -help
Go To TOP ___
API Server
-- Install
pip install -U ddgs[api]
-- CLI
ddgs api # Start server in foreground ddgs api -d # Start in detached mode (background) ddgs api -s # Stop detached server ddgs api --host 127.0.0.1 --port 4479 # Default port 4479 ddgs api -pr socks5h://127.0.0.1:9150 # With proxy
-- Docker compose
git clone https://github.com/deedy5/ddgs && cd ddgs docker-compose up --build
-- Bash script
git clone https://github.com/deedy5/ddgs && cd ddgs chmod +x start_api.sh ./start_api.sh
Endpoints
1bf7af3c838fOBSERVED · 2026-09-22Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add ddgs -- uvx ddgs
{
"mcpServers": {
"ddgs": {
"command": "uvx",
"args": [
"ddgs"
]
}
}
}Exposed tools (6)
6 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
extract_content | read | Extract content from a URL. |
search_books | read | Perform a book search using DDGS. |
search_images | read | Perform an image search using DDGS. |
search_news | read | Perform a news search using DDGS. |
search_text | read | Perform a text search using DDGS. |
search_videos | read | Perform a video search using DDGS. |
Trust audit
CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (1 observation(s))
- Shell
- declared (2 observation(s))
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (3)
package = importlib.import_module(package_name)
module = importlib.import_module(modname)
.pre-commit-config.yaml
Gates applied: no_behavioural_pass.
1bf7af3c838ffull audit observations/trust-audit/mcp-server/deedy5__ddgs-1.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-09-22 | 1bf7af3c838f | CAUTION | B | 89 | source changed, verdict held |
Questions
What is the DDGS MCP server?
A metasearch library that aggregates results from diverse web search services
What tools does DDGS expose?
6 in total: 6 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is DDGS safe to connect to an agent?
With care. The audit graded it B (89/100) and found 3 things worth knowing before you trust this server, listed below with the exact line each was found on.
What credentials does DDGS need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (1bf7af3c838f), read on 2026-09-22. The repository is watched and re-audited when it changes.