82 lines
2.1 KiB
Markdown
82 lines
2.1 KiB
Markdown
---
|
|
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` |