duckduckgo-search

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

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill duckduckgo-search-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill duckduckgo-search-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Built-in web search tools often require API keys or paid services, and agents cannot assume those are configured. This Skill provides a free, keyless web search path through DuckDuckGo, with clear runtime detection so searches work whether the ddgs CLI or Python library is available. ## Core Features & Use Cases - Four Search Modes: Run text, news, image, and video searches through the ddgs CLI or the Python DDGS class, with region, time, and safe-search filters. - Runtime Detection Flow: Check whether the ddgs CLI is installed before choosing between terminal commands and Python imports, avoiding failed assumptions about sandboxed runtimes. - Search-then-Extract Workflow: Retrieve titles, URLs, and snippets from DuckDuckGo, then hand off the best URL to a content-extraction tool for full page text. - Use Case: When FIRECRAWL_API_KEY is not set and built-in web search is unavailable, run ddgs text -q "fastapi deployment guide" -m 3 -o json to gather candidate sources, then extract the top result for a research summary. ## Quick Start Ask the agent to search DuckDuckGo for a topic such as "latest AI regulation news" and return the top five results with titles and URLs.

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 -q "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 web search?▼

Import DDGS from the ddgs package and call methods like text, news, images, or videos inside a context manager. Always pass max_results as a keyword argument, since positional usage raises an error on all methods.

Does DuckDuckGo search require an API key?▼

No, DuckDuckGo search through the ddgs package requires no API key or account. This makes it a practical fallback when services like Firecrawl are not configured, though rate limiting can occur after many rapid requests.

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

Terminal and execute_code are separate Python runtimes, so installing ddgs in a shell does not make it importable elsewhere. Verify the package in the specific runtime with an import test before using the Python API there.

What are the limitations of DuckDuckGo search results?▼

DuckDuckGo returns titles, URLs, and snippets rather than full page content, so a separate extraction step is needed for complete articles. Results may also be rate-limited, blocked from some cloud IPs, or have variable fields between versions.