功能描述

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.

使用说明 (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

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

版本历史

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.

元数据

Slug ddg

版本 1.0.0

许可证 —

累计安装 20

当前安装数 20

历史版本数 1

常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2727 次。

如何安装 Ddg？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install ddg」即可一键安装，无需额外配置。

Ddg 是免费的吗？

是的，Ddg 完全免费（开源免费），可自由下载、安装和使用。

Ddg 支持哪些平台？

Ddg 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Ddg？

由 instant-picture（@instant-picture）开发并维护，当前版本 v1.0.0。

Ddg