home / skills / openclaw / skills / ddg-search

ddg-search skill

safe

/skills/paradoxfuzzle/ddg-search

This skill performs web searches using DuckDuckGo to fetch relevant results when API access is unavailable.

This is most likely a fork of the ddg-search-1-0-0 skill from openclaw

npx playbooks add skill openclaw/skills --skill ddg-search

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

465 B

---
name: ddg-search
description: Perform web searches using DuckDuckGo. Use when web search is needed and no API key is available or Brave Search is not preferred.
---

# DuckDuckGo Search Skill

This skill provides the ability to perform web searches using DuckDuckGo.

## Usage

To use this skill, provide a search query. The skill will return relevant results from DuckDuckGo.

## Scripts

- `search.py`: Executes the DuckDuckGo search and returns the results.

Overview

This skill performs web searches using DuckDuckGo to retrieve relevant results without requiring an API key. It is designed as a lightweight search tool when direct web queries are needed and Brave Search is not preferred. The implementation focuses on simple query input and returning concise, relevant links and snippets.

How this skill works

Provide a search query to the skill and it issues a DuckDuckGo search, parses returned results, and formats links and short descriptions. The core script executes the request, extracts titles, URLs, and summaries, and returns them as structured results for consumption by other tools or users. It avoids requiring authentication or special credentials, relying on public DuckDuckGo endpoints and lightweight parsing.

When to use it

Quickly retrieve web search results without an API key
Integrate a simple search capability into an agent or bot
Fallback search option when Brave Search or other APIs are unavailable
Archive or index search results for backup and reference
Run ephemeral queries where privacy-focused DuckDuckGo is preferred

Best practices

Keep queries concise and focused for more relevant results
Post-process returned snippets to remove boilerplate or duplicates
Rate-limit queries when running at scale to avoid scraping issues
Validate and sanitize URLs before automated fetching or indexing
Cache frequent queries to reduce repeated network requests

Example use cases

Agent needs a current web fact and no API key is available
Collecting links and summaries for an archival snapshot of search results
Embedding a privacy-minded search fallback in a chat assistant
Testing search-driven workflows during development without paid APIs
Harvesting initial link sets for manual review or downstream scraping

FAQ

Do I need an API key to use this skill?

No. The skill is designed to run without API keys by using DuckDuckGo's public search endpoints.

Is this suitable for heavy production traffic?

Use caution. For high-volume production use, implement caching and rate limits or consider an official API to ensure stability.