duckduckgo-search

Search DuckDuckGo for web, news, image, and video results without an API key.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill duckduckgo-search-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/optional-skills/research/duckduckgo-search
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill duckduckgo-search-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Enables reliable DuckDuckGo searches when paid APIs or built-in web_search tools are unavailable, removing barriers to ad-hoc web, news, image, and video discovery without API keys.

Core Features & Use Cases

  • Preferred terminal-first workflow: use the ddgs CLI when available to avoid assumptions about runtime Python packages.
  • Python fallback: supports the ddgs Python library after explicit installation and runtime verification for programmatic search.
  • Use cases include quick literature discovery, current news checks, image and video lookups for visual references, and seeding URLs for downstream extraction.

Quick Start

Search DuckDuckGo for "fastapi deployment guide" and return the top five results with titles and URLs.

Frequently Asked Questions about duckduckgo-search

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

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

You can search DuckDuckGo without an API key by using the ddgs CLI for terminal-based lookups or the ddgs Python package for programmatic web, news, image, and video searches.

What is the best way to get DuckDuckGo web search results in Python?

The best way to get DuckDuckGo web search results in Python is installing the ddgs package, verifying it in the runtime, and passing max_results as a keyword argument to retrieve text, news, image, or video links.

Can I use DuckDuckGo for current news and image lookups when built-in search is unavailable?

Yes, you can perform DuckDuckGo news and image lookups when built-in web_search or paid APIs are unavailable by utilizing the ddgs CLI or the ddgs Python library for ad-hoc discovery.

Do I need the ddgs CLI installed to perform terminal-based DuckDuckGo searches?

You need the ddgs CLI present in your terminal to perform terminal-based DuckDuckGo searches, which is the preferred terminal-first workflow to avoid assuming runtime Python package availability.

Why does my DuckDuckGo Python search fail without passing max_results?

Your DuckDuckGo Python search fails because the ddgs package requires explicitly passing max_results as a keyword argument in the execution runtime to properly return text, news, image, or video search results.

Are there limitations to using DuckDuckGo for seeding URLs for downstream extraction?

A limitation of using DuckDuckGo for seeding URLs is that it requires either the ddgs CLI or a verified ddgs Python runtime installation, and it is designed for ad-hoc discovery rather than heavy bulk scraping.