duckduckgo-search

Search DuckDuckGo for text, news, images, and videos via Python or CLI.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/cloudliness/Hermes-Autonomous-AI-Agent-Dialed-In-For-Windows-11 --skill duckduckgo-search-cloudliness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duckduckgo-search
Source: https://github.com/cloudliness/Hermes-Autonomous-AI-Agent-Dialed-In-For-Windows-11/tree/main/skills/research/duckduckgo-search
Command: npx skills add https://github.com/cloudliness/Hermes-Autonomous-AI-Agent-Dialed-In-For-Windows-11 --skill duckduckgo-search-cloudliness

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Free web search without API keys, enabling access to DuckDuckGo results for text, news, images, and videos.

Core Features & Use Cases

  • Text Search: Retrieve titles, URLs, and snippets for general research.
  • News Search: Find current events and updates with keywords.
  • Image Search: Acquire image results with titles and sources.
  • Video Search: Access video results with titles and providers.
  • CLI & Python API: Use the ddgs CLI or the Python DDGS class for structured results.
  • Workflow to Extract Content: Follow up with web_extract to fetch full content when needed.

Quick Start

Run a text search for 'python async programming' using the Python API or CLI and review the top 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 free web searches without an API key?

Free web search without an API key is possible using DuckDuckGo to retrieve text, news, images, and videos. You simply use the Python ddgs library or the CLI to query relevant results directly without authentication setup.

Can I extract full web page content after finding search results?

Yes, full page content can be extracted using the web_extract feature. After retrieving relevant search results, you follow up with web_extract to fetch complete content from targeted URLs when snippets are insufficient.

Does DuckDuckGo search support finding current news and images?

DuckDuckGo search supports finding current news and images by delivering targeted results. You can find current events with keywords in news search, and acquire image results complete with titles and sources.

What is the best way to run DuckDuckGo searches in a Python script?

The best way to run DuckDuckGo searches in a Python script is using the DDGS class from the ddgs library. This Python API provides structured results containing titles, URLs, and snippets for integration into data workflows.

Do I need to configure authentication to use the ddgs CLI for text searches?

No, you do not need to configure authentication or API keys to use the ddgs CLI for text searches. It performs free web searches using DuckDuckGo directly, allowing you to retrieve titles, URLs, and snippets immediately.