# Ddg Search

> Search the web. Use for general lookups, research, and finding information online.

- **Type:** Skill
- **Install:** `agentstack add skill-shaunandrews-agent-skills-ddg-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shaunandrews](https://agentstack.voostack.com/s/shaunandrews)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shaunandrews](https://github.com/shaunandrews)
- **Source:** https://github.com/shaunandrews/agent-skills/tree/main/skills/ddg-search

## Install

```sh
agentstack add skill-shaunandrews-agent-skills-ddg-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# DuckDuckGo Search

Search the web using DuckDuckGo's HTML interface. No API key required.

## When to Use

- Web searches when you want to avoid API rate limits
- Quick lookups that don't need Brave's advanced features
- Fallback when `web_search` is unavailable or limited
- Any general web search task

## Usage

```bash
# Basic search (returns JSON)
ddg-search "your query"

# Limit results
ddg-search "your query" -n 5

# Region-specific results
ddg-search "your query" -r uk-en

# Plain text output (easier to read)
ddg-search "your query" --text

# Safe search off (for unrestricted results)
ddg-search "your query" --safe off
```

## Options

| Flag | Default | Description |
|------|---------|-------------|
| `-n, --count` | 10 | Number of results to return |
| `-r, --region` | (none) | Region code (e.g., `us-en`, `uk-en`, `de-de`) |
| `-s, --safe` | moderate | Safe search: `off`, `moderate`, `strict` |
| `-t, --text` | false | Output plain text instead of JSON |

## Output

### JSON (default)

```json
{
  "query": "wordpress block development",
  "results": [
    {
      "title": "Block Editor Handbook",
      "url": "https://developer.wordpress.org/block-editor/",
      "snippet": "Documentation for building blocks..."
    }
  ],
  "count": 1
}
```

### Plain Text (`--text`)

```
Query: wordpress block development

1. Block Editor Handbook
   https://developer.wordpress.org/block-editor/
   Documentation for building blocks...
```

## Region Codes

Common region codes for `-r` flag:

- `us-en` — United States
- `uk-en` — United Kingdom
- `ca-en` — Canada (English)
- `au-en` — Australia
- `de-de` — Germany
- `fr-fr` — France
- `es-es` — Spain
- `wt-wt` — No region (worldwide)

## Notes

- Results are from DuckDuckGo's index (may differ from Google/Brave)
- Rate limited to 1 request/second — be patient with multiple searches
- No instant answers or rich snippets — organic results only
- If parsing fails, DuckDuckGo may have changed their HTML structure

## Troubleshooting

**No results returned:**
- Check your query isn't too specific
- Try without region filtering
- Verify internet connectivity

**Error "HTTP 403":**
- You may be rate limited — wait a moment and retry
- Check if DuckDuckGo is accessible in your network

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shaunandrews](https://github.com/shaunandrews)
- **Source:** [shaunandrews/agent-skills](https://github.com/shaunandrews/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shaunandrews-agent-skills-ddg-search
- Seller: https://agentstack.voostack.com/s/shaunandrews
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.