A versatile command-line tool for scraping DuckDuckGo search results into multiple structured data formats including JSON, CSV, and Markdown.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ddg-search-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ddg-search-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ddg-search?
ddg-search is a robust command-line interface designed to fetch and parse search results from DuckDuckGo without the overhead of a full browser environment. It is an essential utility for developers using Openclaw Skills who need to programmatically access web search data for automation, research, or data mining. By scraping the HTML interface, it provides a lightweight alternative to official APIs while offering deep control over pagination and output formatting.
The tool is engineered with developer workflows in mind, sending clean data to stdout while reserving stderr for progress updates. This separation makes it incredibly easy to pipe search results directly into other utilities or AI processing pipelines. Whether you are building a custom search engine or augmenting an AI agent's knowledge base, ddg-search delivers structured, reliable information.
ddg-search Use Cases
- Injecting real-time web search results into LLM prompts using the token-saving compact format.
- Automating lead generation or URL gathering for SEO and market research.
- Generating CSV reports of search results for spreadsheet-based data analysis.
- Creating custom RSS or Atom feeds using the OpenSearch XML output format.
- Monitoring specific topics over time using the built-in time filters (day, week, month, year).
How ddg-search Works
- The user executes a search command specifying a query and optional flags for format, region, or time.
- The CLI tool sends a request to DuckDuckGo's HTML search interface.
- To avoid bot detection, the tool automatically implements random delays between 800ms and 2900ms when fetching multiple pages.
- The raw HTML is parsed to extract titles, links, snippets, and metadata like zero-click answers.
- The structured results are formatted and printed to the terminal or redirected to a file.
ddg-search Setup
To get started with ddg-search for your Openclaw Skills projects, install the package globally via npm:
npm install -g ddg-search
Verify the installation by running a simple test query:
ddg-search "Openclaw Skills"
ddg-search Data Schema & Taxonomy
The skill supports various data structures to suit different technical requirements:
| Format | Output Type | Primary Use Case |
|---|---|---|
| json | Structured Object | Full metadata including spelling corrections and zero-click answers. |
| jsonl | Line-delimited JSON | High-speed streaming and piping to tools like jq. |
| csv | Tabular | Spreadsheet integration and data science workflows. |
| compact | Minimalist Text | Optimal for AI agents to minimize token consumption. |
| markdown | Formatted Text | Direct embedding into documentation or notes. |
| opensearch | Atom XML | Feed readers and legacy search integrations. |
ddg-search Advanced Features
- Multi-page scraping with the ability to set unlimited results for deep research.
- Region-specific search modifiers (e.g., -r us-en) to retrieve localized content.
- Flexible time-filtering to narrow results to the most recent information.
- Seamless integration with jq for complex field extraction (e.g.,
ddg-search "query" | jq -r '.items[].link'). - Stealth-focused design with randomized intervals to minimize service interruptions.
SKILL.md
Loading
Related Openclaw Skills
Landing Page Converter
A high-conversion page generator for AI agents that utilizes proven 10-section frameworks to turn raw offers into professional sales or lead capture pages.
Email Capture Generator
An AI-powered generator for creating conversion-optimized lead magnets and squeeze pages using a proven 5-section marketing framework.
DuckDB CLI Specialist
A powerful CLI-based tool for high-performance SQL analysis and seamless data conversion across multiple file formats.
Jungle Executor
A high-discipline execution engine that enforces the Jungle Laws to prevent narrative bias and technical errors in trading and task management.
ddgs-search
A zero-config, multi-engine web and academic search tool that provides clean JSON results without requiring API keys or subscriptions.
ClawGuard Task & Gateway Watchdog
A lightweight system-level watchdog designed to monitor sub-agent processes and automate configuration recovery for the OpenClaw gateway.
Featured*
