Login
ysm-dev/ddgr-skillMIT2 files

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

Use this skillView repositoryView on skills.sh
Specification
Skill ID
ysm-dev/ddgr-skill/ddgr
Publisher
ysm-dev
Repository
ddgr-skill
Installs
0
Files
2
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

ysm-dev/ddgr-skill/ddgrInstalls these files
  • README.md
  • SKILL.md

What this skill tells the agent

ddgr Web Search

Search DuckDuckGo from the terminal using 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

ddgr --noua --np --json "search query"

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

FlagDescription
-n NNumber of results (0-25, default 10)
-t SPANTime filter: d (day), w (week), m (month), y (year)
-w SITESearch within a specific site
-r REGRegion-specific search (e.g., us-en, uk-en, in-en)
-xShow full URLs instead of domain only
-j"I'm Feeling Ducky" - open first result in browser
-iRetrieve instant answer only
--unsafeDisable safe search
--revList results in reversed order
-p URIHTTPS proxy (also reads https_proxy env var)

DuckDuckGo Bangs

Bangs redirect searches to other sites. Escape ! in bash/zsh:

ddgr --noua --np \!w "search term"      # Wikipedia
ddgr --noua --np \!so "python error"    # StackOverflow  
ddgr --noua --np \!gh "repo name"       # GitHub
ddgr --noua --np \!yt "video topic"     # YouTube
ddgr --noua --np \!a "product"          # Amazon

Full bang list: https://duckduckgo.com/bang

Search Keywords

ddgr --noua --np --json "filetype:pdf annual report"
ddgr --noua --np --json "site:reddit.com python tips"

Examples

Basic search:

ddgr --noua --np --json "python asyncio tutorial"

Recent results (last week):

ddgr --noua --np --json -t w "latest news topic"

Site-specific search:

ddgr --noua --np --json -w stackoverflow.com "parse JSON"

Region-specific (India, English):

ddgr --noua --np --json -r in-en "IPL cricket"

Instant answer:

ddgr --noua --np -i "weather new york"

Limit to 5 results:

ddgr --noua --np --json -n 5 "quick query"

JSON Output Structure

Each result contains:

  • title: Page title
  • url: Full URL
  • abstract: Description/snippet

Parse with jq:

ddgr --noua --np --json "query" | jq '.[].title'
ddgr --noua --np --json "query" | jq -r '.[0].url'  # First result URL

Use this skill in a project

Open any RiverX project, search the Skills panel for ysm-dev/ddgr-skill/ddgr, and install it in one click.

Use this skill