← 返回 Skills 市场
810
总下载
1
收藏
6
当前安装
2
版本数
在 OpenClaw 中安装
/install duckduckgo-websearch
功能描述
Perform private, high-quality web searches using DuckDuckGo's Instant Answer API with fallback to scrape top 5 links and summaries without requiring API keys.
使用说明 (SKILL.md)
DuckDuckGo Websearch Skill
Purpose
- Provide a stable, privacy-minded websearch skill using DuckDuckGo's Instant Answer JSON API as primary source and a lightweight HTML SERP scrape as a fallback for richer link lists.
- Return structured results: concise summary (if available), top 5 links with titles and snippets, and optional short summary of a landed page when requested.
When to use
- Use this skill when the user asks to "search the web", "find links about X", "summarize search results for Y", or any task requiring quick web lookup without paid search APIs.
- Prefer the skill when privacy-friendly sources are acceptable and rate limits / API keys for other search providers are unavailable.
Design principles
- Progressive disclosure: SKILL.md contains the trigger and workflow. Detailed parsing and helpers are in scripts/ so the agent can execute them without loading large text.
- Fail gracefully: if Instant Answer returns limited data, the skill falls back to a minimal HTML fetch-and-parse to extract top results.
- Safety: avoid returning raw HTML; always sanitize snippets and obey robots (basic checks).
Bundled resources
- scripts/ddg_search.js — Node script that performs the search and returns JSON (summary, links[]). Executable by the agent when the skill is invoked.
- references/usage_examples.md — short examples of prompts that should trigger this skill.
Outputs
- JSON shape returned from scripts/ddg_search.js: { "query": "...", "summary": "short abstract or empty", "links": [ {"title":"...","url":"...","snippet":"..."}, ... up to 5], "source": "instant-answer|serp-fallback", "notes": "any warnings" }
Security & limits
- The script uses DuckDuckGo's public instant-answer endpoint (no key). For many queries this is enough; for others the SERP fallback will perform a lightweight HTML request. Respect rate limits and avoid heavy scraping.
- Do not follow or fetch pages that explicitly disallow crawling via robots.txt for automation-intended user agents.
Installation / Usage (for maintainer)
- Place this skill in ~/.openclaw/workspace/skills/duckduckgo-websearch
- Ensure node is available (Node 18+). The script has zero external dependencies (uses built-in https/http and node-html-parser).
- Test manually: node scripts/ddg_search.js "query terms"
Trigger examples (see references/usage_examples.md)
- "Search DuckDuckGo for recent news about [topic] and give me top links."
- "Find the best tutorials for Django channels and summarize top results."
安全使用建议
This skill appears to implement a DuckDuckGo search and SERP parse and does not request credentials, but there are a few things to check before installing or running it:
- Clarify the dependency: SKILL.md says "zero external dependencies" but the bundle includes package.json/package-lock and requires node-html-parser. Ensure you or the agent installs dependencies (npm install) before running, or update the script to avoid the dependency.
- Robots.txt policy: SKILL.md says the skill will respect robots.txt, but the provided ddg_search.js does not check robots.txt. If you need strict crawling rules, update the script to fetch and respect robots.txt or restrict it from following landing-page fetches.
- Network activity: the script makes outbound HTTPS requests to api.duckduckgo.com and duckduckgo.com/html. If you have network policies, be aware of these endpoints.
- Run tests locally first: execute the script in a controlled environment (after installing dependencies) to confirm behavior and inspect output before allowing autonomous agent use.
- If you want higher assurance: ask the publisher to remove the contradiction in SKILL.md and provide an explicit install step (or vendor the parser) and/or add robots.txt checks in code.
Given these inconsistencies (especially the false claim about dependencies), I rate the package as suspicious rather than outright benign.
功能分析
Type: OpenClaw Skill
Name: duckduckgo-websearch
Version: 1.0.1
The skill bundle provides a DuckDuckGo web search functionality, using its Instant Answer API and a lightweight SERP scraping fallback. The `SKILL.md` instructions are clear, align with the stated purpose, and include safety guidelines (e.g., avoiding raw HTML, respecting robots.txt). The `scripts/ddg_search.js` script uses standard Node.js modules (`https`, `http`, `querystring`) and the `node-html-parser` library to perform requests exclusively to DuckDuckGo's domains and parse the results. There is no evidence of data exfiltration, unauthorized command execution, persistence mechanisms, or prompt injection attempts designed for malicious actions. The input query is properly encoded for URL parameters, mitigating injection risks. All components are consistent with a benign web search utility.
能力评估
Purpose & Capability
Name/description align with the code: the Node script queries DuckDuckGo Instant Answer API and falls back to a SERP HTML fetch. However, SKILL.md asserts the script has "zero external dependencies" while the bundle includes package.json and package-lock.json declaring node-html-parser — so the code actually depends on an external npm package.
Instruction Scope
Runtime instructions are scoped to web search and returning JSON results. They tell the agent to run the bundled Node script and to respect robots.txt. The script itself performs only GET requests to DuckDuckGo endpoints and parses SERP HTML. The inconsistency: SKILL.md requires obeying robots.txt for page fetches, but the provided script does not check robots.txt (and the script does not fetch landing pages anyway). No unexpected file reads, env leaks, or external endpoints beyond DuckDuckGo are present.
Install Mechanism
There is no install spec (instruction-only), but the repo includes package.json and package-lock with an external dependency (node-html-parser) resolved from the npm registry. SKILL.md claims "zero external dependencies," which is incorrect. This mismatch means running the script as-is may fail unless node-html-parser is installed; it also means the skill implicitly relies on npm-registry packages (standard but worth noting). There are no suspicious download URLs in package-lock (packages come from the npm registry).
Credentials
The skill requests no environment variables, no credentials, and accesses no configuration paths. Network access to DuckDuckGo is expected and proportionate to the stated purpose.
Persistence & Privilege
The skill does not request persistent presence (always is false) and does not modify system or other-skill configs. It only runs a local script when invoked and prints JSON to stdout.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install duckduckgo-websearch - 安装完成后，直接呼叫该 Skill 的名称或使用
/duckduckgo-websearch触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Added _meta.json file to the skill package.
- No code or functional changes were made.
v1.0.0
- Initial release of the DuckDuckGo Websearch skill.
- Provides high-quality, privacy-focused web search using DuckDuckGo's Instant Answer API with a lightweight SERP scraping fallback.
- Returns structured results: concise summary (if available), top 5 links with titles and snippets, and optional page summaries on request.
- Designed for general or site-specific web search tasks, emphasizing privacy and no need for API keys.
- Includes scripts for searching and bundled usage examples for prompt triggers.
元数据
常见问题
Duckduckgo Websearch 是什么？
Perform private, high-quality web searches using DuckDuckGo's Instant Answer API with fallback to scrape top 5 links and summaries without requiring API keys. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 810 次。
如何安装 Duckduckgo Websearch？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install duckduckgo-websearch」即可一键安装，无需额外配置。
Duckduckgo Websearch 是免费的吗？
是的，Duckduckgo Websearch 完全免费（开源免费），可自由下载、安装和使用。
Duckduckgo Websearch 支持哪些平台？
Duckduckgo Websearch 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Duckduckgo Websearch？
由 Ian Choi（@ianwchoi）开发并维护，当前版本 v1.0.1。
推荐 Skills