# Ddgr Web Search

> Run DuckDuckGo web searches from the terminal using `ddgr` with JSON output. Use when the task calls for lightweight web search, quick result triage, or filtering by region/time/site.

- Skill: `s-kostyaev/ddgr-web-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add s-kostyaev/ddgr-web-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/s-kostyaev/ddgr-web-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: s-kostyaev (https://skillmd.com/u/s-kostyaev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/s-kostyaev/ddgr-web-search

---


# DDGR Web Search (JSON)

## Overview

Use `ddgr "query" --json` to fetch search results as structured JSON, then extract only the minimal fields needed for the task.

## Workflow

1. Run a JSON search (non-interactive).

```bash
ddgr "cli websearch" --json
```

2. If you need fewer/more results or filters, add options:

```bash
ddgr "cli websearch" --json -n 5
ddgr "cli websearch" --json -t w
ddgr "cli websearch" --json -w "example.com"
ddgr "cli websearch" --json -r "us-en"
```

3. Summarize or cite results using only a small subset of entries. Avoid copying full JSON into context.

## Useful Options (Non-Exhaustive)

- `--json`: output results as JSON
- `-n N`: results per page (0-25)
- `-t d|w|m|y`: time filter (day/week/month/year)
- `-w SITE`: restrict to a site/domain
- `-r REG`: region code (e.g., `us-en`)
- `--unsafe`: disable safe search if needed
- `-x`: expand full URLs
- `--proxy URI`: use HTTPS proxy