duckduckgo-search

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

19|4|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill duckduckgo-search-carterwayneskhizeine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill duckduckgo-search-carterwayneskhizeine

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

You need reliable web research results from DuckDuckGo without requiring an API key or assuming third-party libraries are available in every runtime.

Core Features & Use Cases

  • Free web search (text, news, images, videos): Use DuckDuckGo via the ddgs CLI for fast, dependency-light searching across common research needs.
  • Runtime-aware execution strategy: Prefer ddgs CLI when available, and only use Python DDGS after verifying the package exists in the target runtime.
  • Two-step workflow for deeper content: Use search first to obtain titles/URLs/snippets, then extract full page content with other tools when needed.

Quick Start

Run a text search with the DuckDuckGo CLI by asking for: "Search DuckDuckGo for 'python async programming' and return 5 relevant results."

Frequently Asked Questions about duckduckgo-search

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

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

You can retrieve free DuckDuckGo search results across text, news, images, and videos without an API key by using the runtime-aware execution strategy that targets the `ddgs` CLI.

Can I search DuckDuckGo for news, images, and videos in the same workflow?

Yes, DuckDuckGo web search supports querying across text, news, images, and videos simultaneously, providing URLs and snippets for your research workflow without requiring external API authentication.

Do I need the Python DDGS package installed to use DuckDuckGo search?

No, the runtime-aware execution strategy prefers the `ddgs` CLI first, and only optionally uses the Python DDGS package after verifying its availability in your execution environment.

What is the best way to extract full page content after a DuckDuckGo web search?

The best approach is a two-step workflow: use DuckDuckGo search to obtain titles, URLs, and snippets first, then extract full page content with separate tools for deeper analysis.

Why does my DuckDuckGo search fail when the ddgs CLI is not available?

DuckDuckGo search requires runtime detection of the `ddgs` CLI availability and safe fallback behavior, meaning execution relies on finding the CLI or verifying the Python DDGS package beforehand.

Are there limitations to using free DuckDuckGo search results for research?

A limitation of free DuckDuckGo search is that it provides URLs and snippets first, requiring separate content extraction tools to fetch full page text for deeper research workflows.