DuckDuckGo Search Skill

---

name: duckduckgo-search

description: Search the web using DuckDuckGo. No API key required. Supports instant answers and HTML scraping modes. Privacy-focused search alternative.

homepage: https://duckduckgo.com

metadata:

openclaw:

emoji: "🦆"

requires:

bins: ["python3"]

---

# DuckDuckGo Search Skill

使用 DuckDuckGo 进行隐私保护的网页搜索，**无需 API Key**。

特点

---

使用方法

基本搜索

python3 scripts/duckduckgo_search.py "搜索关键词"

指定结果数量

python3 scripts/duckduckgo_search.py "Python 教程" -n 10

选择搜索模式

# Instant 模式（快速，适合事实性问题）
python3 scripts/duckduckgo_search.py "Python 是什么" --mode instant

# HTML 模式（完整搜索结果）
python3 scripts/duckduckgo_search.py "Python 教程" --mode html

带关键信息总结

python3 scripts/duckduckgo_search.py "伊朗局势" --summarize

JSON 输出

python3 scripts/duckduckgo_search.py "API" --json

---

参数说明

| 参数 | 说明 | 默认值 |

|------|------|--------|

| `query` | 搜索关键词（必需） | - |

| `-n, --top-k` | 返回结果数量 | 5 |

| `--mode` | 搜索模式：`instant` / `html` | `html` |

| `--fetch-content` | 抓取网页内容（仅 html） | false |

| `--summarize` | 生成关键信息总结 | false |

| `--json` | 输出原始 JSON | false |

---

搜索模式对比

| 模式 | 优点 | 缺点 | 适用场景 |

|------|------|------|----------|

| **Instant** | 快速、稳定 | 结果有限 | 事实性问题、定义查询 |

| **HTML** | 完整搜索结果 | 可能被反爬 | 一般搜索、需要多个结果 |

Instant 模式示例

python3 scripts/duckduckgo_search.py "Python 编程语言"

**输出**：

🔍 DuckDuckGo 搜索结果 (3 条)
============================================================

1. Python (programming language) - Wikipedia
   🔗 https://en.wikipedia.org/wiki/Python_(programming_language)
   📝 Python is a high-level, general-purpose programming language...
   📊 来源：instant

2. Python.org
   🔗 https://www.python.org/
   📝 The official home of the Python Programming Language...
   📊 来源：instant

HTML 模式示例

python3 scripts/duckduckgo_search.py "Python 入门教程" --mode html -n 10

---

输出格式

标准输出（默认）

🔍 DuckDuckGo 搜索结果 (5 条)
============================================================

1. 标题
   🔗 https://example.com
   📝 内容摘要...
   📊 来源：instant/html

JSON 输出

[
  {
    "title": "标题",
    "url": "https://example.com",
    "snippet": "摘要",
    "source": "instant",
    "type": "abstract"
  }
]

---

在 OpenClaw 中使用

自动搜索（根据 SOUL.md）

搜一下 Python 教程

手动调用

exec("python3 skills/duckduckgo-search/scripts/duckduckgo_search.py '关键词' -n 5")

---

限制与注意事项

⚠️ 速率限制

⚠️ 结果质量

⚠️ 反爬虫

---

与 Tavily 搜索对比

| 特性 | DuckDuckGo | Tavily |

|------|------------|--------|

| **API Key** | 不需要 | 需要 |

| **成本** | 免费 | 免费额度 + 付费 |

| **结果质量** | 一般 | 优秀（AI 总结） |

| **稳定性** | 一般 | 高 |

| **适用场景** | 轻量搜索 | 生产环境 |

**建议**：

---

故障排除

问题 1：无搜索结果

**原因**：Instant API 没有相关答案

**解决**：切换到 HTML 模式

python3 scripts/duckduckgo_search.py "关键词" --mode html

问题 2：403 Forbidden

**原因**：被 DuckDuckGo 限制

**解决**：

1. 等待几分钟后重试

2. 降低请求频率

3. 使用代理 IP

问题 3：URL 无法访问

**原因**：DuckDuckGo 重定向链接未正确解析

**解决**：检查 `extract_real_url()` 函数

---

示例查询

# 事实性问题（Instant 模式）
python3 scripts/duckduckgo_search.py "Python 是谁创造的"

# 教程搜索（HTML 模式）
python3 scripts/duckduckgo_search.py "Python 入门教程" --mode html -n 10

# 技术文档
python3 scripts/duckduckgo_search.py "Python requests 库用法" --mode html

# 获取 JSON 用于程序处理
python3 scripts/duckduckgo_search.py "API" --json

---

相关技能

---

*基于 DuckDuckGo 公开端点，仅供学习使用。生产环境建议使用官方 API。*