ddg-search

Search the web via DuckDuckGo HTML and output titles, URLs, and snippets.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/guyru/ai-stuff --skill ddg-search-guyru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ddg-search
Source: https://github.com/guyru/ai-stuff/tree/main/skills/ddg-search
Command: npx skills add https://github.com/guyru/ai-stuff --skill ddg-search-guyru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Web searching and content discovery without API keys, using DuckDuckGo's HTML results and lightweight parsing to deliver results quickly.

Core Features & Use Cases

  • Web search from the command line using DuckDuckGo HTML results (no API key)
  • Return titles, URLs, and snippets with optional JSON output
  • Fetch and extract readable text from a target page using the bundled fetch script

Quick Start

Run python3 {baseDir}/scripts/search.py "Python tutorials" to retrieve the top search results.

Frequently Asked Questions about ddg-search

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

FAQPage Schema
How do I search the web from the command line without an API key?

You can search the web from the command line without an API key by running a Python script that queries DuckDuckGo HTML results. It parses the HTML to extract page titles, URLs, and snippets directly in your terminal.

What is the best way to get DuckDuckGo search results formatted as JSON?

To get DuckDuckGo search results formatted as JSON, use a scraping script that queries DuckDuckGo HTML. It performs lightweight HTML parsing to extract titles, URLs, and snippets, supporting configurable JSON output for CLI workflows.

Can I fetch and extract readable text from a specific web page using Python?

Yes, you can fetch and extract readable text from a specific web page using the bundled fetch script. Applied in CLI workflows, it retrieves the target page and extracts readable text for quick research alongside your search results.

Do I need to install external dependencies to scrape DuckDuckGo HTML results?

No, you do not need to install external dependencies to scrape DuckDuckGo HTML results. The script relies entirely on Python's standard library to perform HTML parsing and return titles, URLs, and snippets without API keys.

What are the limitations of using DuckDuckGo HTML scraping for web search?

The limitations of using DuckDuckGo HTML scraping for web search include relying on the site's HTML structure, which may change without notice. It is designed for quick research and configurable result limits rather than heavy automated querying.