duckduckgo-search

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Free web search can be constrained by API keys, rate limits, and vendor lock-in. This skill provides a key-free DuckDuckGo search path for fast discovery, research, and validation.

Core Features & Use Cases

  • No API key required: Use the CLI tool (ddgs) or Python API after verifying installation to perform text, news, image, and video searches.
  • Flexible workflow: Prefer CLI when available, or fallback to Python runtime with proper environment checks; includes clear guidance on installation and runtime constraints.

Quick Start

Run a DuckDuckGo search via the CLI if installed, or install the ddgs Python package and use the Python API to search.

Frequently Asked Questions about duckduckgo-search

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

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

Free web search without an API key is possible using DuckDuckGo via the ddgs CLI or Python API. This skill verifies installation and performs text, news, image, and video searches without paid services.

Can I use DuckDuckGo search in Python without registering for an API key?

Yes, DuckDuckGo search in Python works without an API key by importing the ddgs package. The skill checks Python import readiness and falls back to CLI or browser-based tools if unavailable.

What's the best way to run DuckDuckGo searches from the command line?

Running DuckDuckGo searches from the command line is best handled by the ddgs CLI tool. This skill prefers the CLI when available and provides installation guidance if the runtime check fails.

Does the ddgs package support searching for news, images, and videos?

The ddgs package supports text, news, image, and video searches through DuckDuckGo. It can be accessed via the CLI or Python API after verifying that the environment is properly configured.

What happens if DuckDuckGo search is not working because the CLI or Python package is missing?

If DuckDuckGo search is not working due to missing dependencies, this skill includes runtime checks for CLI presence and Python import readiness, falling back to browser-based tools when neither is available.