How do I install the Ddg skill?

Run npx skillmds@latest add modbender/ddg in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ddg?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ddg by modbender — Agent Skill

Name: Ddg
Rating: 4.2 (5 reviews)
Author: modbender

Ddg

Use ddgr (DuckDuckGo from the terminal) to perform privacy-focused web searches from the command line. Use when the user wants to (1) Search the web from the terminal, (2) Perform DuckDuckGo searches without opening a browser, (3) Get quick search results in text format, (4) Search privately without tracking, (5) Use DuckDuckGo bangs (!) from terminal.

modbender Updated Aug 19, 2026 12 repo stars

File contents

ddgr - DuckDuckGo from the Terminal

ddgr is a command-line utility to search DuckDuckGo from the terminal. It provides fast, privacy-focused web searches without opening a browser.

Installation

Via Snap (recommended for Ubuntu):

sudo snap install ddgr

Via PPA:

sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install ddgr

From source:

git clone https://github.com/jarun/ddgr.git
cd ddgr
sudo make install

Dependencies: Python 3.8 or later

Basic Usage

Simple search (non-interactive):

snap run ddgr "search query" --np

Search with specific number of results:

snap run ddgr "search query" --num 5 --np

Search with time limit:

snap run ddgr "query" --time w --np    # past week
snap run ddgr "query" --time m --np    # past month
snap run ddgr "query" --time y --np    # past year

Site-specific search:

snap run ddgr "query" --site github.com --np

JSON output:

snap run ddgr "query" --json --np

Open first result in browser:

snap run ddgr "query" --ducky

Interactive Mode

Run without --np to enter interactive mode:

snap run ddgr "search query"

Interactive commands:

1, 2, 3... → open result in browser
n → next page of results
p → previous page of results
q or Ctrl+D → quit
? → show help

Advanced Options

Option	Description
`-n N`, `--num N`	Show N results per page (0-25, default 10)
`-r REG`, `--reg REG`	Region-specific search (e.g., 'us-en', 'uk-en')
`-t SPAN`, `--time SPAN`	Time limit: d (day), w (week), m (month), y (year)
`-w SITE`, `--site SITE`	Search specific site
`-x`, `--expand`	Show complete URLs
`--json`	Output in JSON format
`--ducky`	Open first result in browser
`--np`, `--noprompt`	Non-interactive mode
`--unsafe`	Disable safe search

DuckDuckGo Bangs

Use DuckDuckGo bangs to search specific sites:

snap run ddgr "!w Linux" --np        # Wikipedia search
snap run ddgr "!yt music" --np       # YouTube search
snap run ddgr "!gh python" --np      # GitHub search
snap run ddgr "!a books" --np        # Amazon search

Make it Easier with an Alias

Add to ~/.bashrc or ~/.zshrc:

alias ddg='snap run ddgr'

Then use:

ddg "search query" --np

Privacy Features

No user tracking or profiling
Do Not Track enabled by default
Works over Tor network (with proxy)
HTTPS proxy support
No stored search history

Examples

Search for tech news:

snap run ddgr "latest AI news 2025" --num 5 --np

Find Ubuntu tutorials:

snap run ddgr "Ubuntu tutorial" --site askubuntu.com --np

Search recent Python documentation:

snap run ddgr "Python 3.12 features" --time m --np

Use bang to search Wikipedia:

snap run ddgr "!w OpenClaw" --np

Troubleshooting

Command not found:

Ensure ddgr is installed via snap: sudo snap install ddgr
Use full command: snap run ddgr instead of just ddgr

No results:

Check internet connection
Try without --np to see if interactive mode works
Verify DuckDuckGo is accessible in your region

Slow response:

DuckDuckGo HTML interface can be slower than main site
Use --time to limit results by time for faster queries

More Information

---name: ddgdescription: Use ddgr (DuckDuckGo from the terminal) to perform privacy-focused web searches from the command line. Use when the user wants to (1) Search the web from the terminal, (2) Perform DuckDuckGo searches without opening a browser, (3) Get quick search results in text format, (4) Search privately without tracking, (5) Use DuckDuckGo bangs (!) from terminal.--- # ddgr - DuckDuckGo from the Terminal **ddgr** is a command-line utility to search DuckDuckGo from the terminal. It provides fast, privacy-focused web searches without opening a browser. ## Installation ### Via Snap (recommended for Ubuntu): ```bash sudo snap install ddgr ``` ### Via PPA: ```bash sudo add-apt-repository ppa:twodopeshaggy/jarun sudo apt-get update sudo apt-get install ddgr ``` ### From source: ```bash git clone https://github.com/jarun/ddgr.git cd ddgr sudo make install ``` **Dependencies:** Python 3.8 or later ## Basic Usage ### Simple search (non-interactive): ```bash snap run ddgr "search query" --np ``` ### Search with specific number of results: ```bash snap run ddgr "search query" --num 5 --np ``` ### Search with time limit: ```bash snap run ddgr "query" --time w --np # past week snap run ddgr "query" --time m --np # past month snap run ddgr "query" --time y --np # past year ``` ### Site-specific search: ```bash snap run ddgr "query" --site github.com --np ``` ### JSON output: ```bash snap run ddgr "query" --json --np ``` ### Open first result in browser: ```bash snap run ddgr "query" --ducky ``` ## Interactive Mode Run without `--np` to enter interactive mode: ```bash snap run ddgr "search query" ``` **Interactive commands:** - `1`, `2`, `3`... → open result in browser - `n` → next page of results - `p` → previous page of results - `q` or `Ctrl+D` → quit - `?` → show help ## Advanced Options | Option | Description | |--------|-------------| | `-n N`, `--num N` | Show N results per page (0-25, default 10) | | `-r REG`, `--reg REG` | Region-specific search (e.g., 'us-en', 'uk-en') | | `-t SPAN`, `--time SPAN` | Time limit: d (day), w (week), m (month), y (year) | | `-w SITE`, `--site SITE` | Search specific site | | `-x`, `--expand` | Show complete URLs | | `--json` | Output in JSON format | | `--ducky` | Open first result in browser | | `--np`, `--noprompt` | Non-interactive mode | | `--unsafe` | Disable safe search | ## DuckDuckGo Bangs Use DuckDuckGo bangs to search specific sites: ```bash snap run ddgr "!w Linux" --np # Wikipedia search snap run ddgr "!yt music" --np # YouTube search snap run ddgr "!gh python" --np # GitHub search snap run ddgr "!a books" --np # Amazon search ``` ## Make it Easier with an Alias Add to `~/.bashrc` or `~/.zshrc`: ```bash alias ddg='snap run ddgr' ``` Then use: ```bash ddg "search query" --np ``` ## Privacy Features - No user tracking or profiling - Do Not Track enabled by default - Works over Tor network (with proxy) - HTTPS proxy support - No stored search history ## Examples ### Search for tech news: ```bash snap run ddgr "latest AI news 2025" --num 5 --np ``` ### Find Ubuntu tutorials: ```bash snap run ddgr "Ubuntu tutorial" --site askubuntu.com --np ``` ### Search recent Python documentation: ```bash snap run ddgr "Python 3.12 features" --time m --np ``` ### Use bang to search Wikipedia: ```bash snap run ddgr "!w OpenClaw" --np ``` ## Troubleshooting **Command not found:** - Ensure ddgr is installed via snap: `sudo snap install ddgr` - Use full command: `snap run ddgr` instead of just `ddgr` **No results:** - Check internet connection - Try without `--np` to see if interactive mode works - Verify DuckDuckGo is accessible in your region **Slow response:** - DuckDuckGo HTML interface can be slower than main site - Use `--time` to limit results by time for faster queries ## More Information - GitHub: https://github.com/jarun/ddgr - DuckDuckGo: https://duckduckgo.com - Bangs: https://duckduckgo.com/bang

Frequently asked questions

Ddg