Description

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.

README (SKILL.md)

ddgr - DuckDuckGo from the Terminal

Name: Ddg
Author: instant-picture

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

Usage Guidance

This skill is instruction-only and simply documents installing and using the ddgr CLI. Before installing, verify the install source you choose (snap, the PPA owner, or the GitHub repo jarun/ddgr) and only run install commands you trust. Installing via snap or apt/ppa requires sudo — review and trust the PPA. Building from source runs make install as root, so inspect the repo if you plan to use that path. Adding an alias to your shell rc is benign but changes your shell setup. If you plan to use Tor/proxy features, configure and verify your proxy/Tor client separately. No credentials are requested by the skill itself.

Capability Analysis

Type: OpenClaw Skill Name: ddg Version: 1.0.0 The skill bundle provides instructions for installing and using `ddgr`, a command-line utility for DuckDuckGo searches. All commands and instructions are directly related to the stated purpose of performing privacy-focused web searches from the terminal. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent. Installation methods use standard package managers (snap, apt) or direct compilation from the official GitHub repository, and subsequent usage involves only the `ddgr` command and common shell utilities for processing its output.

Capability Assessment

✓ Purpose & Capability

Name/description map directly to the provided instructions for installing and using ddgr (DuckDuckGo CLI). The SKILL.md only references ddgr functionality (search flags, bangs, JSON output, proxies/Tor) and does not ask for unrelated services, credentials, or system access.

✓ Instruction Scope

Runtime instructions are limited to installing ddgr (snap/PPA/from-source), running the ddgr command, using flags, and optionally adding a shell alias. There are no instructions to read arbitrary files, exfiltrate data, or contact unknown endpoints. The install steps do use sudo (normal for package install) and suggest proxy/Tor usage but do not include any extra config collection.

✓ Install Mechanism

This is instruction-only (no automated install spec). Recommended install methods are standard (snap, distro PPA, GitHub repo). Cloning from GitHub (jarun/ddgr) is expected for building from source and is a well-known host; the skill does not perform any automatic downloads itself.

✓ Credentials

The skill declares no required environment variables, credentials, or config paths. That matches the simple terminal-search purpose.

✓ Persistence & Privilege

always:false and no install-time code means the skill does not demand permanent/system-wide presence or modify other skills. It is user-invocable and may be invoked autonomously by the agent (platform default), which is appropriate for this kind of helper.

Version History

v1.0.0

- Initial release of the ddg skill. - Enables privacy-focused web searches from the terminal using ddgr (DuckDuckGo). - Supports non-interactive and interactive search, DuckDuckGo bangs, and direct browser opening. - Provides text and JSON output options, site-specific queries, and time-limited searches. - Includes advanced features: region and time filters, safe search toggle, proxy support, and privacy-focused defaults. - Offers detailed usage instructions, example searches, and troubleshooting tips.

Metadata

Slug ddg

Version 1.0.0

License —

All-time Installs 20

Active Installs 20

Total Versions 1

Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 2727 downloads so far.

How do I install Ddg?

Run "/install ddg" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ddg free?

Yes, Ddg is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Ddg support?

Ddg is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ddg?

It is built and maintained by instant-picture (@instant-picture); the current version is v1.0.0.

More Skills

Ddg