duckduckgo-search

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

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/dawsonblock/HERMY --skill duckduckgo-search-dawsonblock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/dawsonblock/HERMY/tree/main/hermes-agent-2026.4.23/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/dawsonblock/HERMY --skill duckduckgo-search-dawsonblock

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

DuckDuckGo Search provides fast, free web results without API keys, enabling quick access to diverse content when traditional search APIs are unavailable.

Core Features & Use Cases

  • CLI-first search: Use the ddgs CLI for text, news, images, and videos with simple commands.
  • Python API option: Verify and use the Python package in environments where a Python runtime can import ddgs.
  • Fallback and guidance: If the CLI is unavailable or not installed, guidance is provided to install or use alternative built-in tools.
  • Use Case: Quickly surface relevant web content for research, product discovery, or competitive intel when API access is restricted.

Quick Start

Install ddgs and run a text search to fetch quick results from DuckDuckGo.

Frequently Asked Questions about duckduckgo-search

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

FAQPage Schema
How do I get web search results without an API key?

To perform free web search without an API key, use this Skill to query DuckDuckGo for text, news, images, and videos via the ddgs CLI or Python package. It provides fast results without authentication.

Can I use DuckDuckGo search in Python if the CLI is not installed?

Yes, if the ddgs CLI is unavailable, you can use the Python API for DuckDuckGo search by importing the ddgs package in your runtime environment. If neither is installed, the Skill provides installation guidance.

What types of content can I retrieve using ddgs for information retrieval?

Using ddgs for information retrieval allows you to fetch text, news, images, and videos from DuckDuckGo. It supports both CLI commands and Python API calls depending on your environment.

Does DuckDuckGo web search require any dependencies to run?

DuckDuckGo web search requires the ddgs CLI or the ddgs Python package to be installed. If neither dependency is present, the Skill gracefully falls back to providing setup and installation guidance.

When should I prefer the CLI over the Python API for web search?

Prefer the ddgs CLI for quick text, news, image, or video searches in terminal environments. Use the Python API when your runtime can import the ddgs package for integrated scripting and automated information retrieval.

What happens if neither the ddgs CLI nor Python package is available in my environment?

If neither the ddgs CLI nor the Python package is available, the DuckDuckGo search Skill gracefully falls back to guidance, advising you on how to install the required tools or use alternative built-in options.