duckduckgo-search

Search the web via DuckDuckGo CLI or Python package without API keys.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Free web search without API keys, enabling quick access to text, news, images, and videos when paid services or APIs are restricted.

Core Features & Use Cases

  • CLI-driven search via the ddgs tool for rapid results without embedding API keys.
  • Python API usage is supported after validating runtime availability, enabling programmatic searches.
  • Use cases include quick research, monitoring news, gathering visual references, and staying up-to-date on topics.

Quick Start

Run a quick web search using the ddgs CLI by providing a keyword and optional max results.

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

You can search the web without an API key by using DuckDuckGo to retrieve text, news, images, and videos directly via the ddgs CLI tool or Python package, bypassing paid access requirements.

Can I get news and image results from DuckDuckGo programmatically in Python?

Yes, you can obtain news and image results programmatically in Python. The Skill validates the runtime availability of the ddgs Python package to enable text, news, image, and video searches.

Do I need to install the ddgs package to use DuckDuckGo search in my scripts?

Yes, you need the ddgs package installed. The Skill enforces that either the CLI ddgs is available or the Python ddgs package is installed at runtime before executing web searches.

What is the best way to run free web searches from the command line?

The best way to run free web searches from the command line is using the ddgs CLI tool, which provides rapid text, news, image, and video results without embedding API keys or requiring paid access.

Why do my DuckDuckGo web searches fail when missing the max_results parameter?

DuckDuckGo web searches fail without the max_results parameter because the Skill strictly enforces that max_results is supplied as a keyword argument to execute the query successfully.