| name | duckduckgo |
| description | Searches DuckDuckGo via its HTML endpoint using scrapling. Returns results as markdown (default), raw HTML, compact JSON, or YAML. Use when performing web searches from within an agent workflow without requiring a search API key or external service. |
DuckDuckGo Search
Overview
Searches DuckDuckGo via its HTML endpoint (html.duckduckgo.com/html/) using scrapling for fetching and parsing. Supports four output formats — all sourced from the same HTML API:
- Markdown (default) — clean, AI-targeted markdown from scrapling
- HTML — raw
.web-result HTML elements
- JSON — compact array of
{title, url, domain, snippet} objects
- YAML — structured list of result mappings
No API key or external search service required. Uses uvx 'scrapling[shell]' for ephemeral execution.
When to Use
- Performing web searches from within an agent workflow
- Gathering search result snippets, titles, and URLs programmatically
- Research tasks that need structured search output (JSON/YAML) for downstream processing
- Situations where Google/Bing APIs are unavailable or require authentication
Usage Examples
Markdown (default)
Run search.sh with a query — no format flag needed:
bash scripts/search.sh "tangled group"
Output is clean markdown produced by scrapling's --ai-targeted mode, streamed directly to stdout.
HTML
Request raw HTML when you need the full DOM structure:
bash scripts/search.sh --format html