duckduckgo-search

Search text, news, images, and videos via DuckDuckGo without API keys.

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

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 results from DuckDuckGo across text, news, images, and videos without setup overhead.

Core Features & Use Cases

  • CLI-based search: Use the ddgs CLI for fast text, news, image, and video searches.
  • Python API (DDGS): Import and use the DDGS class in Python runtimes after verifying installation.
  • Fallback guidance: Provides guidance for environments where the CLI or Python package is unavailable, including a small helper script at scripts/duckduckgo.sh.

Quick Start

Use the CLI to run a text search, or import DDGS in Python to retrieve and parse 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 with DuckDuckGo without an API key?

You can perform a DuckDuckGo web search without an API key by using the ddgs CLI tool or importing the DDGS class in Python, enabling quick access to text, news, image, and video results.

Can I retrieve DuckDuckGo news and image results directly in a Python script?

Yes, you can retrieve DuckDuckGo news and image results in a Python script by importing the DDGS class, which allows you to programmatically execute searches and parse the returned data.

What is the best way to run DuckDuckGo text searches from the command line?

The best way to run DuckDuckGo text searches from the command line is using the ddgs CLI workflow, which provides a fast and direct method for querying and displaying search results in the terminal.

Do I need the ddgs package to use the DuckDuckGo Python search API?

Yes, you need the ddgs package installed to use the DuckDuckGo Python search API, as the DDGS class and its search functionalities depend on this specific dependency to operate correctly.

What should I do if the DuckDuckGo CLI or Python package is unavailable in my environment?

If the DuckDuckGo CLI or Python package is unavailable in your environment, the Skill provides fallback guidance and includes a helper script at scripts/duckduckgo.sh to assist you.

Why use a no-API-key DuckDuckGo search tool instead of other web search APIs?

A no-API-key DuckDuckGo search tool eliminates setup overhead and registration requirements, allowing immediate access to text, news, image, and video search results directly via CLI or Python runtimes.