ddgs-web-search

What This Skill Does

The ddgs-web-search skill provides a powerful, lightweight interface to the DuckDuckGo search engine, allowing OpenClaw agents to perform real-time web lookups. By leveraging the ddgs Python package, this skill bypasses the need for complex API keys, offering a frictionless way to fetch external information. It supports multiple search modes, including general web queries and news-specific feeds, while providing granular control over geographical regions, time-based filtering, and safety settings. Designed for high interoperability, the output can be retrieved as plain text or structured JSON, making it ideal for integration into automated agent pipelines and data-processing tasks.

Installation

Installation is streamlined through the OpenClaw ecosystem and the uv package manager. To get started, ensure you have the uv tool installed on your system. You can install the skill via the ClawHub command: clawhub install openclaw/skills/skills/bird-frank/ddgs-search-api. Once installed, the skill resides in your project library. If managing dependencies manually, ensure you have the ddgs library available in your Python environment. For most OpenClaw workflows, the installation automatically configures the path so that you can invoke the search tool from any agent process without further path manipulation.

Use Cases

This skill is perfect for scenarios requiring live data retrieval without the overhead of enterprise search engine APIs. Common use cases include:

1. Research Assistance: Agents can perform rapid fact-checking by pulling snippets from recent news articles.
2. Competitive Intelligence: Monitoring specific keywords or industries across the web to keep agent knowledge bases up to date.
3. Development Automation: Fetching documentation or troubleshooting forum discussions for specific programming errors.
4. Dynamic Context Injection: Gathering real-time background information before performing a primary agent task, such as drafting a summary report or executing a complex coding script.

Example Prompts

1. "Perform a web search for the latest updates on Python 3.13 features and return the top 5 results as JSON."
2. "Search for recent tech news regarding artificial intelligence policy changes from the past week and summarize the main points."
3. "Look up the documentation syntax for the latest version of FastAPI in the US region and provide a list of relevant sources."

Tips & Limitations

To get the best performance, always use the --json flag when your agent needs to parse results programmatically, as this eliminates the need for messy regex extraction. Be mindful that while ddgs is robust, it relies on scraping search results; avoid flooding queries to prevent rate-limiting from the provider. If results are irrelevant, use the --region flag (e.g., us-en or uk-en) to narrow the geographic context of your search. Remember that this tool is designed for web exploration, not as a replacement for high-throughput database queries.