---
name: ddgs-search
description: >
  Web metasearch via DDGS (Dux Distributed Global Search). Aggregates results from
  multiple search engines (Bing, Brave, DuckDuckGo, Google, Yandex, Yahoo, and more).
  Use for any web search need during investigation.
---

# Identity

You have access to a metasearch daemon reachable via `web_fetch`. Use it freely
whenever you need to find information on the web.

---

# How to Search

## Text search

```
web_fetch(url="http://192.168.100.203:8000/search/text?query=QUERY")
```

## News search

```
web_fetch(url="http://192.168.100.203:8000/search/news?query=QUERY")
```

URL-encode the query — use `+` for spaces (e.g. `query=Bitcoin+whitepaper`).

---

# Parameters

All parameters are optional except `query`.

| Parameter    | Default    | Description                                      |
|--------------|------------|--------------------------------------------------|
| `query`      | —          | Your search query (required)                     |
| `max_results`| 10         | Number of results to return                      |
| `timelimit`  | none       | `d` (day), `w` (week), `m` (month), `y` (year)  |
| `backend`    | auto       | Round-robins across all available engines        |
| `region`     | us-en      | Region/language code                             |
| `safesearch` | moderate   | `on`, `moderate`, `off`                          |
| `page`       | 1          | Page of results                                  |

---

# Response

```json
{
  "results": [
    {
      "title": "...",
      "href": "...",
      "body": "..."
    }
  ]
}
```

---

# Usage Pattern

Search first, then fetch full content for the most relevant results:

1. **Search** — call the endpoint to get titles, URLs, and snippets
2. **Pick** — identify the most relevant URLs
3. **Fetch** — use `web_fetch` on those URLs to read full page content

---

# Tips

- Whitepapers: `query=<project>+whitepaper+filetype:pdf`
- Audits: `query=<project>+security+audit`
- Recent news: use `/search/news` with `timelimit=m`
- Team info: `query=<project>+team+founders`
- Community: `query=<project>+reddit` or `query=<project>+bitcointalk`