← Back to Skills Marketplace
shelehovnick1-spec

Ddg 1.0.0

by shelehovnick1-spec · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
613
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install ddg-1-0-0
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...
README (SKILL.md)

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

Usage Guidance
This skill is a documentation/instruction package for the ddgr command‑line tool. It asks you to install software (via snap, an apt PPA, or by building from the GitHub repo) and to add a shell alias — these are normal for a CLI helper. Before installing: verify you trust the PPA or GitHub source, review the repository (especially if you use 'sudo make install'), and be aware that installing system packages requires elevated privileges. No credentials or unusual system access are requested by this skill.
Capability Analysis
Type: OpenClaw Skill Name: ddg-1-0-0 Version: 1.0.0 The skill bundle is designed to enable privacy-focused web searches using the `ddgr` command-line utility. All files (SKILL.md, references/usage-patterns.md) provide instructions and examples for installing and using `ddgr` via standard methods like Snap, PPA, or Git clone from its official GitHub repository (github.com/jarun/ddgr). There is no evidence of malicious intent, such as data exfiltration, unauthorized command execution, persistence mechanisms, obfuscation, or prompt injection attempts against the OpenClaw agent. The instructions are clear, align with the stated purpose, and utilize legitimate software distribution channels for a known open-source tool.
Capability Assessment
Purpose & Capability
Name/description (ddgr/DuckDuckGo CLI) match the content: installation and usage instructions for ddgr. The skill declares no credentials, binaries, or config paths beyond typical shell changes; nothing requested is out of scope for a terminal search helper.
Instruction Scope
SKILL.md only describes installing ddgr (snap, PPA, or from source), running it, aliases, and common usage patterns. It does not instruct the agent to read unrelated files, exfiltrate data, or contact unknown endpoints. It does advise editing ~/.bashrc/~/ .zshrc and running commands with sudo for installation, which is normal for installing system packages.
Install Mechanism
This is an instruction-only skill with no built-in install spec. The README recommends snap, a PPA, or cloning the official GitHub repo (https://github.com/jarun/ddgr). Those are standard install paths for ddgr and are proportionate to the stated purpose.
Credentials
The skill requests no environment variables, secrets, or config paths. The only persistent change suggested is adding a shell alias to ~/.bashrc or ~/.zshrc, which is appropriate for a CLI convenience guide.
Persistence & Privilege
Flags show default privileges (not always:true). The skill does not request persistent always-on presence or attempt to modify other skills or system-wide agent settings. Installation instructions require normal package install privileges (sudo) which is expected.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ddg-1-0-0
  3. After installation, invoke the skill by name or use /ddg-1-0-0
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the ddg skill. - Enables privacy-focused web searches from the terminal using ddgr (DuckDuckGo). - Supports quick, text-based search results, DuckDuckGo bangs (!), and site-specific queries. - Offers both interactive and non-interactive modes, JSON output, and advanced filtering options. - No user tracking, history, or profiling; includes proxy and Tor support. - Includes installation instructions, example usage, troubleshooting tips, and alias setup.
Metadata
Slug ddg-1-0-0
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Ddg 1.0.0?

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

How do I install Ddg 1.0.0?

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

Is Ddg 1.0.0 free?

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

Which platforms does Ddg 1.0.0 support?

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

Who created Ddg 1.0.0?

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

💬 Comments