duckduckgo-search

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Free web search via DuckDuckGo without API keys, enabling quick access to information without paid services or signups.

Core Features & Use Cases

  • CLI search: use the ddgs CLI for fast text, news, images, and videos.
  • Python API path: integrate search into scripts or notebooks after verifying the package is installed.
  • Fallback guidance: when the CLI is unavailable, follow clear steps to use alternative web tools and maintain functionality.

Quick Start

Use the duckduckgo-search skill to perform a quick web search and fetch results for your query.

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 web search from a Python script without an API key?

You can perform a web search without an API key by using the DuckDuckGo search skill, which verifies the `ddgs` package is installed before importing it to retrieve relevant text, news, image, and video results directly in your code.

Can I fetch breaking news and images via DuckDuckGo using a CLI?

Yes, you can fetch breaking news and images via the DuckDuckGo CLI. The skill enforces runtime checks to verify CLI availability, allowing you to execute fast searches for general queries, images, and videos without requiring an API key.

What is the best way to gather research information without paid search services?

The best way to gather research information without paid services is using DuckDuckGo search. It enables quick access to general queries and due diligence information without signups or API keys, supporting both CLI commands and Python API integration.

What should I do if the ddgs CLI is unavailable during a search task?

If the ddgs CLI is unavailable, you should follow the skill's documented fallback guidance. It provides clear steps to use alternative web tools and maintain search functionality, or you can verify the Python package availability to use the API path instead.

Does DuckDuckGo search work in research notebooks for quick information gathering?

Yes, DuckDuckGo search works in research notebooks. After verifying the Python package is installed, you can integrate the search functionality directly into your scripts or notebooks to gather information across text, news, images, and videos without API keys.

Are there limitations to using DuckDuckGo for automated web searches?

Limitations include dependency on the `ddgs` package or CLI availability. The skill enforces runtime checks before import and documents fallback paths, ensuring resilient operation but requiring package verification to maintain functionality during automated web searches.