# osintverse-community/ddgr

Searches DuckDuckGo from the command line and returns titles, URLs and snippets

## Install and run

```sh
ot install osintverse-community/ddgr
ot run osintverse-community/ddgr d:github.com --query otinstaller
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/ddgr","inputs":{"query":"otinstaller"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | yes |  | Search keywords; DuckDuckGo operators work |
| `site` | domain | no |  | Only search this site |
| `num` | integer | no |  | Results per page, 0 to 25 (default 10) |

## Outputs

Finds: url, other.

- `other`: Result title and abstract

## What a run does

- Does not contact the target.
- Does not collect personal data.
- Does not need an account.
- Does not notify the target.
- Usually takes about 5 seconds.
- Publisher's note: DuckDuckGo may rate-limit or block requests from cloud or datacenter IP addresses.
- Connects to the internet.

An agent needs the person's consent before running this tool, because it goes online. See https://otinstaller.com/docs/agents#consent.

## Trust

- Latest version: 2.2.0
- Signed: no
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: GPL-3.0
- Runtime: Python wheel (pipx), pinned by hash
- Repository: https://github.com/osintverse-community/ddgr
- Packaged by the community from a third-party tool

## Links

- Web page: https://otinstaller.com/osintverse-community/ddgr
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/ddgr
- README: https://github.com/osintverse-community/ddgr#readme
- Homepage: https://github.com/jarun/ddgr
- Security details: https://otinstaller.com/osintverse-community/ddgr/security