duckduckgo-search

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill duckduckgo-search-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill duckduckgo-search-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? When built-in web search tools are unavailable or require API keys (such as a missing FIRECRAWL_API_KEY), you still need a way to find current information online. This Skill provides free DuckDuckGo search across text, news, images, and videos with no API key required. ## Core Features & Use Cases - CLI-First Search: Uses the ddgs command-line tool via terminal for text, news, image, and video queries with region, time, and safe-search filters. - Python API Fallback: Supports the DDGS Python class after verifying the ddgs package is installed in that specific runtime. - Search-then-Extract Workflow: Returns titles, URLs, and snippets, then pairs with web extraction tools to retrieve full page content. - Use Case: You need the latest AI regulation news but have no search API key configured. Run ddgs news -q "AI regulation" -m 5 to get dated headlines with sources, then extract the most relevant article. ## Quick Start Ask the agent to search DuckDuckGo for a topic, for example: "Search DuckDuckGo for the five most recent news articles about AI regulation."

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 and time filters.

How to use the ddgs Python library for web 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 tool requires no API key or account. This makes it a practical fallback when services like Firecrawl are not configured, though DuckDuckGo may rate-limit rapid requests.

Why does ddgs return empty results or fail to import?▼

Empty results usually indicate rate limiting, so wait a few seconds and retry or adjust the query. A ModuleNotFoundError means the ddgs package is not installed in that Python runtime, since terminal and execute_code environments are separate.

Can DuckDuckGo search extract full page content?▼

No, ddgs returns only titles, URLs, and snippets, not full page content. To get complete articles, search first to find the best URL, then use a web extraction tool, browser tool, or curl to retrieve the page.