duckduckgo-search-skills

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

DuckDuckGo Search Skill

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

特点

• ✅ 无需 API Key - 直接使用
• ✅ 隐私保护 - 不追踪用户
• ✅ 两种模式 - Instant API / HTML Scraping
• ✅ 免费无限制 - 无配额限制

---

使用方法

基本搜索

bash

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

指定结果数量

bash

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

选择搜索模式

bash

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

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

带关键信息总结

bash

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

JSON 输出

bash

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 模式示例

bash

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

输出：

text

🔍 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 模式示例

bash

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

---

输出格式

标准输出（默认）

text

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

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

JSON 输出

json

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

---

在 OpenClaw 中使用

自动搜索（根据 SOUL.md）

text

搜一下 Python 教程

手动调用

bash

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

---

限制与注意事项

⚠️ 速率限制

• DuckDuckGo 没有官方 API，使用 HTML 端点可能被限制
• 建议请求间隔 2-5 秒
• 大量请求可能触发 403 错误

⚠️ 结果质量

• Instant 模式：只返回"即时答案"和相关主题，不是完整搜索
• HTML 模式：返回完整结果，但解析可能不稳定

⚠️ 反爬虫

• DuckDuckGo 可能检测并阻止自动化请求
• 如遇 403 错误，稍后重试
• 生产环境建议使用官方 API（如 Tavily、Brave）

---

与 Tavily 搜索对比

特性	DuckDuckGo	Tavily
API Key	不需要	需要
成本	免费	免费额度 + 付费
结果质量	一般	优秀（AI 总结）
稳定性	一般	高
适用场景	轻量搜索	生产环境

建议：

• 日常轻量搜索 → DuckDuckGo
• 生产环境/高质量需求 → Tavily

---

故障排除

问题 1：无搜索结果

原因：Instant API 没有相关答案
解决：切换到 HTML 模式

bash

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

问题 2：403 Forbidden

原因：被 DuckDuckGo 限制
解决：

1. 等待几分钟后重试
2. 降低请求频率
3. 使用代理 IP

问题 3：URL 无法访问

原因：DuckDuckGo 重定向链接未正确解析
解决：检查 extract_real_url() 函数

---

示例查询

bash

# 事实性问题（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

---

相关技能

• tavily-search - AI 增强搜索（推荐用于生产）
• web_search - OpenClaw 内置搜索（需 Brave API）
• web_fetch - 网页内容提取

---

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