ddgs

[](https://github.com/deedy5/ddgs/releases) [](https://pypi.org/project/ddgs)

A metasearch library that aggregates results from diverse web search services.

• Install
• CLI version
• API Server (with MCP Integration)
• Engines
• DDGS class
• 1. text()
• 2. images()
• 3. videos()
• 4. news()
• 5. books()
• Disclaimer

___

pip install -U ddgs      # Base install
pip install -U ddgs[api] # With API server

ddgs --help

Go To TOP ___

• CLI

ddgs api    # Start in foreground
ddgs api -d # Start in detached mode
ddgs api -s # Stop detached server
ddgs api --host 127.0.0.1 --port 9000 --proxy socks5h://127.0.0.1:9150  # Custom host / post / 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

• MCP Endpoints (for AI assistance):
• http://localhost:8000/sse - SSE transport
• API Docs: http://localhost:8000/docs
• Health Check: http://localhost:8000/health

• search_text - Web text searches
• search_images - Image searches
• search_news - News searches
• search_videos - Video searches
• search_books - Book searches

{
  "mcpServers": {
    "ddgs-search": {
      "url": "http://localhost:8000/sse",
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

[Go To TOP](