ddg-search: 为 AI 智能体提供的无 API 网页搜索 - Openclaw Skills

什么是 DuckDuckGo 网页搜索？

ddg-search 技能是一个轻量且高效的解决方案，旨在为 AI 智能体启用网页搜索功能，而无需昂贵或复杂的 API 配置。通过内置的 web_fetch 工具利用 DuckDuckGo Lite HTML 界面，该技能允许智能体直接检索搜索标题、摘要和 URL。当主要搜索提供商遇到频率限制或配置错误时，它是完美的备选方案。

作为 Openclaw Skills 生态系统的一部分，该工具优先考虑简单性和可靠性。它开箱即用，零依赖，非常适合自托管智能体或无法安装外部包的受限环境。它通过提供干净的、基于文本的结果来简化研究过程，方便大语言模型（LLM）解析和分析。

下载入口:https://github.com/openclaw/skills/tree/main/skills/jakelin/ddg-web-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install ddg-web-search

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 ddg-web-search。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

DuckDuckGo 网页搜索 应用场景

• 当 Brave 或 Google 搜索 API 密钥缺失或无效时的备用搜索机制。
• 在自主编码会话期间进行基于网页的研究和数据收集。
• 使用基于区域的过滤功能为特定国家/地区定位搜索结果。
• 识别相关的文档或论坛帖子以解决技术问题。

DuckDuckGo 网页搜索 工作原理

1. AI 智能体生成搜索查询并进行 URL 编码，将空格替换为加号。
2. 技能调用 web_fetch 工具，针对带有编码查询的 DuckDuckGo Lite 端点。
3. 系统检索 HTML 内容并将其提取为纯文本，以去除不必要的冗余信息。
4. 智能体解析带编号的结果，识别自然链接并忽略赞助内容。
5. 智能体随后可以获取所发现的最相关 URL 的完整内容。

DuckDuckGo 网页搜索 配置指南

此技能不需要外部 API 密钥。确保您的智能体可以访问 web_fetch 工具。要在您的 Openclaw Skills 工作流中使用此功能，只需为您的智能体提供以下命令结构：

# 标准搜索查询
web_fetch(url="https://lite.duckduckgo.com/lite/?q=search+term", extractMode="text", maxChars=8000)

DuckDuckGo 网页搜索 数据架构与分类体系

该技能以从 Lite HTML 界面解析的结构化文本格式返回搜索数据。以下是概念性数据布局：

属性	描述
标题	搜索结果的显示名称
摘要	页面内容的简短文本预览
URL	源材料的直接链接
赞助内容	用于识别和跳过广告链接的标记

name: ddg-search
description: Web search without an API key using DuckDuckGo Lite via web_fetch. Use as a fallback when web_search fails with missing_brave_api_key error, or whenever you need to search the web and no search API is configured. Provides titles, URLs, and snippets for research queries. Zero dependencies — works with just the built-in web_fetch tool.

DuckDuckGo Search via web_fetch

Search the web using DuckDuckGo Lite's HTML interface, parsed via web_fetch. No API key or package install required.

How to Search

web_fetch(url="https://lite.duckduckgo.com/lite/?q=QUERY", extractMode="text", maxChars=8000)

• URL-encode the query — use + for spaces
• Use extractMode="text" (not markdown) for clean results
• Increase maxChars for more results

Region Filtering

Append &kl=REGION for regional results:

• au-en — Australia
• us-en — United States
• uk-en — United Kingdom
• de-de — Germany
• fr-fr — France

Full list: https://duckduckgo.com/params

Example — Australian search

web_fetch(url="https://lite.duckduckgo.com/lite/?q=best+coffee+melbourne&kl=au-en", extractMode="text", maxChars=8000)

Reading Results

Results appear as numbered items with title, snippet, and URL. Skip entries marked "Sponsored link" (ads) — organic results follow.

Search-then-Fetch Pattern

1. Search — query DDG Lite for a list of results
2. Pick — identify the most relevant URLs
3. Fetch — use web_fetch on those URLs to read full content

Tips

• First 1-2 results may be ads — skip to organic results
• For exact phrases, wrap in quotes: q=%22exact+phrase%22
• Add specific terms to narrow results (site name, year, location)

Limitations

• No time/date filtering (DDG Lite doesn't support &df= reliably via fetch)
• Text results only — no images or videos
• Results sourced from Bing (may differ from Google)
• Google search does NOT work via web_fetch (captcha blocked)