# Ddg Search

> A Claude skill from Djarvur/ddg-search.

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

## Install

```sh
agentstack add skill-djarvur-ddg-search-ddg-search
```

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

## About

# DDG Search Skill

Web search and page content fetching for Claude Code without API keys.

## Installation

This skill requires two binaries to be installed in your PATH.

### Install via go install

```bash
go install github.com/Djarvur/ddg-search/cmd/ddg-search@latest
go install github.com/Djarvur/ddg-search/cmd/page-dump@latest
```

### Verify installation

```bash
which ddg-search
which page-dump

# Test the binaries
ddg-search --help
page-dump --help
```

## Tools

### web-search

Search the web using DuckDuckGo.

**Parameters:**
- `query` (required): The search query string

**Usage:**
```
ddg-search "golang http client best practices"
```

**Output:** Formatted search results with title, URL, and snippet for each result.

**Options:**
- `--max-results int`: Maximum number of results (default: 10)
- `--site string`: Filter results to a specific domain
- `--region string`: Search region (default: "us-en")
- `--time string`: Time filter: d (day), w (week), m (month), y (year)

### page-dump

Fetch a web page and convert it to markdown.

**Parameters:**
- `url` (required): The URL to fetch (HTTP or HTTPS only)

**Usage:**
```
page-dump "https://example.com/article"
```

**Output:** Markdown-formatted content of the web page.

**Options:**
- `--timeout duration`: Request timeout (default: 30s)
- `--user-agent string`: Custom user agent string (default: page-dump/1.0)

## Usage Examples

### Search for information
```
ddg-search "rust async programming guide"
```

### Fetch and read a web page
```
page-dump "https://doc.rust-lang.org/book/ch10-00-generics.html"
```

### Search and then fetch a result
```
# First search
ddg-search "go context timeout"

# Then fetch an interesting result
page-dump "https://pkg.go.dev/context"
```

## Troubleshooting

### "command not found: ddg-search" or "command not found: page-dump"

The binaries are not in your PATH. Ensure `$(go env GOPATH)/bin` is in your PATH:
```bash
export PATH="$PATH:$(go env GOPATH)/bin"
```

### Rate limiting errors

DuckDuckGo may rate-limit requests if you make too many searches in a short time. Wait a few minutes before retrying.

### Timeout errors

If pages are slow to load, increase the timeout:
```
page-dump --timeout 60s "https://slow-example.com"
```

### Invalid URL errors

Ensure the URL:
- Starts with `http://` or `https://`
- Is properly encoded
- Points to a valid web page (not a file download)

### SSL/TLS errors

For sites with certificate issues, this is expected behavior. The tool requires valid TLS certificates for HTTPS connections.

## Source & license

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

- **Author:** [Djarvur](https://github.com/Djarvur)
- **Source:** [Djarvur/ddg-search](https://github.com/Djarvur/ddg-search)
- **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:** yes
- **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-djarvur-ddg-search-ddg-search
- Seller: https://agentstack.voostack.com/s/djarvur
- 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%.