duckduckgo-search

Search DuckDuckGo for text, news, images, and videos via CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/AVOI-CEO/avoi-agent --skill duckduckgo-search-avoi-ceo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/AVOI-CEO/avoi-agent/tree/main/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/AVOI-CEO/avoi-agent --skill duckduckgo-search-avoi-ceo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Free DuckDuckGo web search without API keys, enabling quick access to web results when other search APIs are unavailable.

Core Features & Use Cases

  • CLI-based search using the ddgs tool for text, news, images, and videos, with optional region and time filters.
  • Python API usage via from ddgs import DDGS after verifying that the runtime can import the package.
  • Installation and runtime guidance, including best practices for mixing CLI and Python workflows.

Quick Start

Install ddgs and run a text search using the CLI after installation, for example: ddgs text -k 'example' -m 5.

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 without an API key?

You can retrieve DuckDuckGo web search results without an API key by using the ddgs CLI tool. It provides free access to text, news, images, and videos directly from your command line.

Can I filter DuckDuckGo web search results by region and time?

Yes, DuckDuckGo web search results can be filtered by region and time. The ddgs CLI tool supports these optional parameters to help narrow down text and news query outputs.

What is the best way to get DuckDuckGo news and video results in Python?

The best way to get DuckDuckGo news and video results in Python is importing from ddgs import DDGS. You must verify your runtime can import the package before executing the Python API commands.

How do I output DuckDuckGo search results as JSON from the command line?

You can output DuckDuckGo search results as JSON by running the ddgs CLI tool. It natively formats text, news, image, and video web results into JSON for easy parsing.

Does free web search without API keys have usage limitations?

Free web search without API keys may have runtime and usage limitations. The ddgs tool requires proper installation and environment verification to ensure the CLI and Python API function correctly.