# deedy5/ddgs

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/deedy5-ddgs).**

2,754 stars · 264 forks · Python · MIT

## Links

- GitHub: https://github.com/deedy5/ddgs
- awesome-repositories: https://awesome-repositories.com/repository/deedy5-ddgs.md

## Topics

`api` `ddgs` `mcp` `mcp-server` `metasearch` `python` `search` `websearch`

## Description

ddgs is a metasearch engine and web content extractor that provides a toolkit for programmatically retrieving search results from DuckDuckGo. It functions as a search API server and a Model Context Protocol server to integrate web search capabilities directly into large language model environments.

The project distinguishes itself by aggregating text, image, news, and video results from multiple providers into a single interface. It includes a utility for fetching URLs and converting HTML content into markdown, plain text, or structured data.

The system covers a broad range of search capabilities, including specialized searches for books and filtered searches for images and videos. It provides a command line interface for information retrieval, search data export to JSON and CSV, and the ability to define custom search provider extensions.

The project can be deployed as a containerized service with integrated health checks and proxy support.

## Tags

### Artificial Intelligence & ML

- [MCP Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-servers.md) — Implements a Model Context Protocol server that exposes web search tools to large language models. ([source](https://github.com/deedy5/ddgs/blob/main/README.md))
- [Model Context Protocol Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-assistant-integrations/model-context-protocol-integrations.md) — Integrates web search capabilities into AI models via the Model Context Protocol for grounded responses.
- [Model Context Protocol Implementations](https://awesome-repositories.com/f/artificial-intelligence-ml/model-context-protocol-implementations.md) — Implements the Model Context Protocol to connect search logic to AI models using standard I/O streams.
- [CLI Search Interfaces](https://awesome-repositories.com/f/artificial-intelligence-ml/model-and-dataset-hubs/cli-search-interfaces.md) — Provides a command line interface for executing web search queries and managing result limits. ([source](https://github.com/deedy5/ddgs/blob/main/AGENTS.md))

### Security & Cryptography

- [Metasearch Engines](https://awesome-repositories.com/f/security-cryptography/privacy-focused-search-engines/metasearch-engines.md) — Aggregates results from multiple external search providers into a single unified interface.

### Content Management & Publishing

- [Web Content Extraction Utilities](https://awesome-repositories.com/f/content-management-publishing/web-content-extraction-utilities.md) — Fetches URLs and converts HTML content into markdown, plain text, or rich text formats. ([source](https://github.com/deedy5/ddgs/blob/main/README.md))
- [Web Content Extractors](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/content-parsers/web-content-extractors.md) — Fetches URLs and converts HTML content into markdown, plain text, or structured data for LLM consumption.
- [HTML to Markdown Converters](https://awesome-repositories.com/f/content-management-publishing/html-to-markdown-converters.md) — Transforms raw HTML web page source into cleaned markdown for better LLM consumption.

### Data & Databases

- [Web Page Markdown Converters](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/data-extraction-ingestion/document-processing-tools/llm-powered-parsers/markdown-content-parsers/web-page-markdown-converters.md) — Converts rendered web page HTML into clean markdown for data processing and AI analysis.
- [Web Search APIs](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-information-retrieval/query-interfaces-dsls/web-search-apis.md) — Exposes search functionality via a containerized web API server with automatic documentation. ([source](https://github.com/deedy5/ddgs/blob/main/README.md))
- [Structured Search Retrieval](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-information-retrieval/structured-search-retrieval.md) — Provides a toolkit for the structured retrieval of search results from DuckDuckGo without an official API.
- [Text Search](https://awesome-repositories.com/f/data-databases/text-search.md) — Aggregates text-based search results from multiple backends with region, safety, and time filters. ([source](https://github.com/deedy5/ddgs/blob/main/README.md))
- [Web Search Engines](https://awesome-repositories.com/f/data-databases/web-search-engines.md) — Combines results from multiple web search services into a single interface for comprehensive information retrieval. ([source](https://github.com/deedy5/ddgs/tree/main/skills/ddgs))

### Development Tools & Productivity

- [Search Result Aggregators](https://awesome-repositories.com/f/development-tools-productivity/search-shortcuts/browser-search-engine-shortcuts/search-result-aggregators.md) — Combines search results from multiple different search engines into a single unified interface.
- [Web Search Integrations](https://awesome-repositories.com/f/development-tools-productivity/web-search-integrations.md) — Integrates real-time web search results into custom applications through a dedicated API server.
- [Terminal Search Utilities](https://awesome-repositories.com/f/development-tools-productivity/terminal-search-utilities.md) — Enables quick web searches and data gathering directly from the terminal.

### Web Development

- [Search Aggregators](https://awesome-repositories.com/f/web-development/search-aggregators.md) — Queries multiple search services simultaneously to normalize text, image, news, video, and book results. ([source](https://github.com/deedy5/ddgs#readme))
- [Web Page Retrievers](https://awesome-repositories.com/f/web-development/web-page-retrievers.md) — Programmatically retrieves primary text and structured data from specific URLs. ([source](https://github.com/deedy5/ddgs#readme))