// devtools · deedy5/ddgs

ddgs

A Python metasearch library aggregating many web search services — plus CLI, API and MCP server

★ 3.0k stars⑂ 286 forksMITupdated 2026-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

ddgs is an open-source dev tools project by deedy5 (deedy5/ddgs on GitHub). It has 3,006 GitHub stars and 286 forks, is released under the MIT license, and was last updated on GitHub on 26 August 2026.

Repository
deedy5/ddgs
GitHub stars
3,006
Forks
286
License
MIT
Last updated on GitHub
26 August 2026
Category
Dev Tools
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Choose how you will use it: Python library in code, the ddgs CLI, a self-hosted API server, or an MCP server for an AI client.

  2. Get it from PyPI

    Install the base package, or the [api] or [mcp] extras for the server variants.

  3. Configure

    Optionally set a proxy (http/https/socks5) and pick backends such as Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage or Yandex for text search.

  4. Run your first search

    Call DDGS().text(...) in Python, run a CLI search, or start the MCP server and query it from Cursor or Claude Desktop.

// features

Why people love it

Many search backends

Text search aggregates Bing, Brave, DuckDuckGo, Google, Grokipedia, Mojeek, Startpage, Yandex, Yahoo and Wikipedia.

Five search types

text(), images(), videos(), news() and books() methods, plus extract() to pull content from a URL.

CLI included

A ddgs command-line interface for quick searches from the terminal.

API server extra

pip install ddgs[api] adds a FastAPI server with /search/* and /extract endpoints and Swagger/ReDoc docs.

MCP server extra

pip install ddgs[mcp] adds a stdio MCP server with search_text, search_images, search_news, search_videos, search_books and extract_content tools.

Proxy support

The DDGS class accepts an optional proxy, supporting http, https and socks5 protocols.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone DDGS (optional — you can also just pip install it) and enter the directory.

    git clone https://github.com/deedy5/ddgs.git
    cd ddgs
  2. Install the package

    Install the base library, or add the api/mcp extras as the README shows.

    pip install -U ddgs
  3. Start the MCP server

    Run the MCP server over stdio and connect it from your MCP client config.

    pip install -U ddgs[mcp]
    ddgs mcp
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains DDGS?

It is maintained by deedy5 and contributors on GitHub, and published on PyPI as the ddgs package.

Is DDGS free?

Yes, it is MIT-licensed and free to use. It queries public search services, whose own terms and rate limits still apply.

Does it need a paid API key?

No paid search API key is required by the library itself; it aggregates results from public web search services.

How does it compare to a single-engine search API?

Paid APIs give you one provider's index with an SLA. DDGS is a free library that fans out to many engines and also offers CLI, API-server and MCP modes.

How do I get started?

Run pip install -U ddgs, then use the DDGS class in Python, the ddgs CLI, or ddgs mcp for MCP clients.

// keep exploring

Similar tools

Dev Tools

cli-printing-press

Generates agent-first Go CLIs (plus MCP servers) for any API or website — with local SQLite sync built in

★ 4.8k starsMIT
View guide →
Dev Tools

wigolo

Local-first web search, fetch, crawl and research for AI coding agents over MCP — no API keys.

★ 5.5k starsAGPL-3.0
View guide →
Dev Tools

CodeGraphContext

An MCP server plus a CLI tool that indexes local code into a graph database to provide context to AI assistants.

★ 4.2k starsMIT
View guide →
Dev Tools

dbx

A 25MB database client for 100+ databases — with a built-in AI assistant, MCP server and CLI

★ 25.2k starsApache-2.0
View guide →
Dev Tools

Douyin_TikTok_Download_API

Self-hosted TikTok and Douyin scraper API - no-watermark downloads, MCP and web console

★ 20.5k starsApache-2.0
View guide →
Dev Tools

trafilatura

Trafilatura — a Python and CLI tool to crawl the web and extract clean text and metadata for corpora and RAG.

★ 6.9k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if ddgs is not the right fit.

Get ddgs

Free and open — grab the source, star the repo, and start creating.