duckduckgo-search

Searches the web via DuckDuckGo for text, news, images, and videos without an API key.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/azaanaliraza/operarius --skill duckduckgo-search-azaanaliraza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/azaanaliraza/operarius/tree/main/src-tauri/bin/hermes/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/azaanaliraza/operarius --skill duckduckgo-search-azaanaliraza

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ddgs, and includes scripts (resource) components.

What problem does it solve? It provides free web search through DuckDuckGo when built-in search tools are unavailable or no API key (such as FIRECRAWL_API_KEY) is configured, returning titles, URLs, and snippets for text, news, image, and video queries. ## Core Features & Use Cases - CLI Search: Run text, news, image, and video queries through the ddgs command with region, time, safe-search, and JSON output flags. - Python API: Use the DDGS class for programmatic searches after verifying the ddgs package is installed in that specific runtime. - Runtime Detection: Check whether the ddgs CLI or Python package actually exists before choosing an approach, since terminal and code-execution environments are separate. - Use Case: When a research agent needs current news on a topic but no search API key is set, run ddgs news -k "topic" -m 5 to get dated headlines and sources, then extract the best URL with a content-retrieval tool. ## Quick Start Search DuckDuckGo for the latest news on AI regulation and return the top five results with titles, dates, and sources.

Frequently Asked Questions about duckduckgo-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the web with DuckDuckGo from the command line?▼

Install the ddgs package with pip, then run commands like `ddgs text -k "your query" -m 5` for text results. The CLI also supports news, images, and videos subcommands with region, time, and JSON output flags.

How to use the ddgs Python library for search?▼

Import DDGS from the ddgs package and call methods like ddgs.text("query", max_results=5) inside a context manager. Note that max_results must be passed as a keyword argument, and the package must be installed in that specific Python runtime first.

Does DuckDuckGo search require an API key?▼

No, DuckDuckGo search via the ddgs package requires no API key. This makes it a useful fallback when keys like FIRECRAWL_API_KEY are not configured, though results may be rate-limited under heavy use.

Why does ddgs import fail in execute_code but work in terminal?▼

Terminal and code-execution environments are separate runtimes with independent package installations. Installing ddgs via pip in a shell does not make it importable elsewhere, so verify availability in each runtime before use.

What are the limitations of DuckDuckGo search results?▼

DuckDuckGo returns titles, URLs, and snippets rather than full page content, and may throttle rapid repeated requests. For full article text, follow up with a content extraction tool, and retry with adjusted keywords if results come back empty.