duckduckgo-search

Perform web searches via DuckDuckGo CLI and Python API without an API key.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Free web search using DuckDuckGo. No API key required. Preferred when web_search is unavailable or unsuitable (for example when FIRECRAWL_API_KEY is not set). Can also be used as a standalone search path when DuckDuckGo results are specifically desired.

Core Features & Use Cases

  • Free web search via DuckDuckGo, with no API key required.
  • Supports both CLI (ddgs) and Python API usage, with guidance on when to use each.
  • Includes a built-in workflow for when CLI or Python environments differ.

Quick Start

Run a text search with the ddgs CLI or import the DDGS class in Python to fetch results.

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

You can perform a free DuckDuckGo web search without an API key by using the ddgs CLI tool or by importing the DDGS class in Python. The Skill provides guidance on both methods and includes fallback behavior.

What's the best way to run DuckDuckGo searches from a terminal?

Run a text search using the ddgs CLI tool for terminal-based DuckDuckGo searches. The Skill provides installation steps and enforces clear usage instructions for robust execution across terminal runtimes.

Do I need any dependencies to use DuckDuckGo search in Python?

No external dependencies or API keys are required. The Skill supports both CLI and Python API usage with built-in fallback behavior when the CLI or Python package is unavailable.

When should I use DuckDuckGo search instead of other web search tools?

Use DuckDuckGo search when Firecrawl or other API-based web search tools are unavailable or unsuitable. It serves as a free, no-API-key alternative and a standalone search path when DuckDuckGo results are specifically desired.

What are the limitations of using DuckDuckGo for web search without an API key?

While DuckDuckGo search requires no API key, the Skill notes limitations and includes fallback behavior when the CLI or Python package is unavailable, ensuring robust execution across different runtimes.