duckduckgo-search

Retrieve DuckDuckGo text, news, image, and video search results.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It solves the problem of quickly finding relevant information on the web without needing an API key or paid search services.

Core Features & Use Cases

  • Free web search (DuckDuckGo): Retrieve text, news, images, and videos results for research and fact-finding.
  • CLI-first reliability: Prefer the ddgs CLI when available, while avoiding assumptions about Python package availability in different runtimes.
  • Search-then-extract workflow: Use the search results (titles/URLs/snippets) and then extract full page content using other browsing or extraction tools.
  • Fallback behavior: Use this as a fallback when the primary web search tool is unavailable or when required credentials (e.g., API keys) are missing.

Quick Start

Use the duckduckgo-search skill to search for "python async programming" and return the top 5 text results as a starting point for deeper extraction.

Frequently Asked Questions about duckduckgo-search

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

FAQPage Schema
How do I perform a free web search without an API key?

You can perform free web search without an API key by using DuckDuckGo queries to retrieve text, news, images, and video results. It serves as a reliable fallback in agent workflows when paid API services are unavailable.

Can I use DuckDuckGo search as a fallback when my primary API search tool fails?

Yes, DuckDuckGo search works as a fallback when primary web search tools fail or required credentials are missing. It retrieves search results directly without needing API keys, ensuring your agent workflow continues smoothly.

How do I get news search results using a CLI tool?

You can get news search results using the `ddgs` CLI tool to query DuckDuckGo. It preferentially leverages CLI-first reliability to return titles, URLs, and snippets, optionally verifying or installing the Python `ddgs` package if needed.

Does the ddgs package work across different Python runtimes?

The `ddgs` package availability varies across Python runtimes. The skill avoids assumptions by detecting `ddgs` CLI availability first, then optionally verifying or installing the Python package in the correct runtime environment.

What is the best way to find time-sensitive information without paid search services?

Using DuckDuckGo news and text search is the best way to find time-sensitive information without paid services. It quickly retrieves relevant titles and snippets for research, which can then be extracted for full page content.

Why does the search skill return only snippets and URLs instead of full page content?

The search skill returns only snippets and URLs because it follows a search-then-extract workflow. You use the returned results as a starting point, then extract full page content using other dedicated browsing or extraction tools.