A privacy-focused metasearch skill for AI agents to fetch real-time text, images, news, and videos without requiring an API key.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ddgs
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 ddgs 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 DDGS Web Search Skill?
The DDGS Web Search Skill is a robust integration designed for developers who need to provide AI agents with real-time access to global information. Built on the Dux Distributed Global Search (DDGS) engine, it functions as a privacy-friendly metasearch aggregator that pulls data from multiple search services. As a featured tool within the Openclaw Skills ecosystem, it offers a distinct advantage by requiring no API keys or complex authentication, making it an ideal choice for lightweight and scalable agentic workflows.
This skill prioritizes user anonymity and data integrity, ensuring that search queries are executed without user tracking. It supports diverse search types—including traditional text, news articles, high-resolution images, video content, and book metadata—enabling agents to perform complex multi-modal research tasks efficiently while maintaining a high standard of privacy.
DDGS Web Search Skill Use Cases
- Real-time fact-checking and data retrieval for LLM-based applications.
- Automated monitoring of breaking news and industry trends.
- Harvesting visual assets like images and videos for content generation workflows.
- Extracting bibliographic data and book summaries for research agents.
- Building privacy-compliant web scrapers and crawlers using Openclaw Skills architecture.
How DDGS Web Search Skill Works
- The AI agent or developer initializes the DDGS client within the Python environment.
- The user specifies the search type (text, news, images, videos, or books) and configures parameters like region, safe search, and time limits.
- The skill sends the query to the DDGS engine, which aggregates results from various global search backends.
- Structured data is returned to the agent, including titles, source URLs, and descriptive snippets.
- The agent processes this real-time information to generate informed responses or trigger further automation within the Openclaw Skills framework.
DDGS Web Search Skill Setup
Installation is straightforward and does not require any environment variables for API keys. You can install the skill using pip or uv:
# Recommended installation via uv
uv pip install ddgs
# Or standard installation via pip
pip install ddgs
Once installed, you can immediately begin querying by importing the DDGS class into your project script.
DDGS Web Search Skill Data Schema & Taxonomy
The skill returns structured JSON-compatible data. Below are the common fields found across search results:
| Field | Type | Description |
|---|---|---|
| title | string | The headline or title of the search result |
| href / url | string | The direct link to the webpage or resource |
| body / snippet | string | A short excerpt or summary of the content |
| source | string | The originating platform or publisher |
| date | string | The publication timestamp (primarily for news) |
| image / thumbnail | string | URL of the visual asset (for image/video searches) |
DDGS Web Search Skill Advanced Features
- Multi-modal search support across text, news, images, videos, and books.
- Native support for Model Context Protocol (MCP) to simplify LLM integrations.
- Built-in proxy support for HTTP, HTTPS, and SOCKS5 to handle geographic restrictions.
- Granular filtering options including region codes (e.g., us-en, cn-zh) and time limits.
- Robust exception handling to manage rate limits and network errors within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
What If Factory
A creative brainstorming engine that transforms simple hypothetical questions into detailed, multi-format parallel universe narratives.
Imagination Factory: Parallel Universe Generator
A creative engine that transforms hypothetical What If questions into detailed alternate reality news, consequences, life advice, and memes.
Kugou Mysterious Shop Config Auditor
A specialized tool for auditing Mysterious Shop gift configurations and generating production-ready Apollo JSON files from Excel or Feishu documents.
Baidu Scholar Search Skill
A specialized tool for AI agents to search and retrieve Chinese and English academic literature from Baidu Scholar.
daily.dev API for AI Agents
Bridge the gap between LLM knowledge cutoffs and real-time tech trends using community-validated developer content.
Salai MCP Israeli Grocery Assistant
An Israeli grocery shopping and price-comparison assistant utilizing the Salai MCP endpoint for seamless product discovery and cart management.
Featured*
