duckduckgo-search-skills（duckduckgo 搜索技巧）

DuckDuckGo Search Skill

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

特点

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

使用方法

基本搜索

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

参数说明

搜索模式对比

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")

限制与注意事项

⚠️ 速率限制

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

⚠️ 结果质量

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

⚠️ 反爬虫

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

与 Tavily 搜索对比

建议：

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

故障排除

问题 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

相关技能

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

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