ddg-search

Search the web via DuckDuckGo HTML interface with configurable options and JSON output.

8|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/shaunandrews/agent-skills --skill ddg-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ddg-search
Source: https://github.com/shaunandrews/agent-skills/tree/main/skills/ddg-search
Command: npx skills add https://github.com/shaunandrews/agent-skills --skill ddg-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Web research and quick lookups without API keys or JavaScript, using DuckDuckGo's HTML interface for lightweight searches.

Core Features & Use Cases

  • Privacy-respecting web search using DuckDuckGo's HTML interface (no JavaScript required)
  • Configurable results via count, region, and safe-search options
  • Use case: perform quick research or verify information in environments with API limits or offline tooling

Quick Start

Run ddg-search with a query to fetch web results in JSON by default.

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 with DuckDuckGo without an API key?

You can perform web searches without an API key by scraping DuckDuckGo's HTML interface. This approach fetches results directly via a CLI tool, bypassing the need for official API access or JavaScript.

Can I get DuckDuckGo search results formatted as JSON?

Yes, DuckDuckGo search results can be output as JSON. The CLI tool parses the HTML interface and returns structured JSON data by default, allowing for easy integration into automated workflows.

Does DuckDuckGo HTML scraping support safe search and region filtering?

DuckDuckGo HTML scraping supports safe search and region options. You can configure these parameters along with the result count to filter and control the scope of your web lookups.

What is the best way to automate web research in an environment with API limits?

Automating web research in restricted environments is best handled by scraping DuckDuckGo's HTML interface. It requires no API keys and includes rate limiting to 1 request per second to avoid blocking.

Are there rate limits when scraping DuckDuckGo HTML for search results?

Yes, the DuckDuckGo HTML scraping tool implements rate limiting to 1 request per second. This restriction helps maintain reliable access and prevents your automated lookups from being throttled.