ddgr
Search the web using DuckDuckGo via the ddgr CLI tool. Use when the user asks to search the web, look something up online, find information on the internet, get instant answers, or needs current/real-time data. Also use for DuckDuckGo Bang searches (e.g., "!w" for Wikipedia, "!so" for StackOverflow)
By ysm-dev · 392 installs
npx skills add ysm-dev/ddgr-skill --skill ddgr
Source repository · Upstream listing
ddgr Web Search
Search DuckDuckGo from the terminal using [ddgr](https://github.com/jarun/ddgr).
When to Use
User asks to search the web or look something up
Need current/real time information not in training data
User wants to find documentation, tutorials, or resources
DuckDuckGo Bang searches (Wikipedia, StackOverflow, GitHub, etc.)
Prerequisites
ddgr must be installed: brew install ddgr or pip install ddgr
Basic Usage
Required flags:
noua : Disable user agent (always use this)
np (noprompt): Exit after showing results, no interactive prompt
json : Output in JSON format for parsing (implies np)
Options
Flag Description
n N Number of results (0 25, default 10)
t SPAN Time filter: d (day), w (week), m (month), y (year)
w SITE Search within a specific site
r REG Region specific search (e.g., us en , uk en , in en )
x Show full URLs instead of domain only
j "I'm Feeling Ducky" open first result in browser
i Retrieve instant answer only
unsafe Disable safe search
rev List results in reversed order
p URI HTTPS proxy (also reads https proxy env var)
DuckDuckGo Bangs
Bangs redirect searches to other sites. Escape ! in bash/zsh:
Full bang list: https://duckduckgo.com/bang
Search Keywords
Examples
Basic search:
Recent results (last week):
Site specific search:
Region specific (India, English):
Instant answer:
Limit to 5 results:
JSON Output Structure
Each result contains:
title : Page title
url : Full URL
abstract : Description/snippet
Parse with jq :