DuckDuckGo Websearch 技能

用途

• 提供一个稳定、注重隐私的网页搜索技能，主要调用 DuckDuckGo 的 Instant Answer JSON API，并在需要更丰富的链接列表时，作为备选方案使用轻量级 HTML SERP 页面抓取。
• 返回结构化结果：简明摘要（若可用）、前 5 条链接（含标题与摘要片段），以及在请求时可选返回落地页的简短摘要。

适用场景

• 当用户提出“搜索网页”、“查找关于 X 的链接”、“汇总 Y 的搜索结果”等请求，或任何需快速进行网页检索但无需付费搜索 API 的任务时，应使用本技能。
• 当可接受注重隐私的数据源，且其他搜索引擎因配额限制或缺少 API Key 而不可用时，优先选用本技能。

设计原则

• 渐进式披露：SKILL.md 文件中包含触发条件与工作流程；详细解析逻辑与辅助函数置于 scripts/ 目录下，使 agent 可执行而无需加载大量文本。
• 优雅降级：若 Instant Answer 返回数据有限，技能将自动回退至最小化 HTML 获取与解析流程，以提取顶部搜索结果。
• 安全性：不返回原始 HTML；始终对摘要片段进行清洗，并遵守 robots.txt 协议（基础检查）。

配套资源

• scripts/ddg_search.js — 执行搜索并返回 JSON（含 summary、links[]）的 Node 脚本。该脚本在技能被调用时由 agent 直接执行。
• references/usage_examples.md — 短小精悍的提示词示例，列出了应触发本技能的典型输入。

输出格式

• scripts/ddg_search.js 返回的 JSON 结构如下： { "query": "...", "summary": "简短摘要，若无则为空字符串", "links": [ {"title":"...","url":"...","snippet":"..."}, ... 最多 5 条], "source": "instant-answer|serp-fallback", "notes": "任何警告信息" }

安全与限制

• 脚本使用 DuckDuckGo 公开的 instant-answer 接口（无需 API Key）。多数查询可直接满足；少数情况下，SERP 回退机制会发起一次轻量级 HTML 请求。请尊重速率限制，避免高强度爬取。
• 不得对明确通过 robots.txt 禁止自动化爬取的页面执行跳转或获取操作（针对面向自动化的 User Agent）。

安装 / 使用（维护者专用）

1. 将本技能放置于 ~/.openclaw/workspace/skills/duckduckgo-websearch 目录下。
2. 确保系统已安装 Node（建议 Node 18+）。该脚本无外部依赖，仅使用 Node 内置模块（https/http 和 node-html-parser）。
3. 手动测试方法： node scripts/ddg_search.js "查询关键词"

触发示例（详见 references/usage_examples.md）

• "在 DuckDuckGo 上搜索关于 [主题] 的最新新闻，并提供排名靠前的链接。"
• "查找 Django Channels 最佳教程，并汇总顶部结果。"