词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Duckduckgo Search — 通过 DuckDuckGo 免费搜索网络 — 文本、新闻、图片、视频"
Duckduckgo Search
ddgs CLI；仅在确认当前运行时中 ddgs 可用后，才使用 Python DDGS 库。Skill 元数据
| 来源 | 可选 — 使用 hermes skills install official/research/duckduckgo-search 安装 |
| 路径 | optional-skills/research/duckduckgo-search |
| 版本 | 1.3.0 |
| 作者 | gamedevCloudy |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | search, duckduckgo, web-search, free, fallback |
| 相关 skill | arxiv |
参考：完整 SKILL.md
信息
DuckDuckGo Search
web_search 不可用或不适用时（例如未设置 FIRECRAWL_API_KEY ），优先使用此 skill。也可在明确需要 DuckDuckGo 结果时作为独立搜索路径使用。检测流程
1.
ddgs CLI 已安装，优先使用 terminal + ddgs2.
ddgs CLI 未安装，不要假设 execute_code 能导入 ddgs3.
ddgs4.
execute_code 是独立的运行时execute_code 能导入 ddgsexecute_code 内已预装第三方 Python 包安装
ddgs。from ddgs import DDGS 前，先验证该运行时能否导入 ddgs。方法一：CLI 搜索（推荐）
ddgs 命令存在时，通过 terminal 使用它。这是推荐路径，因为它避免了假设 execute_code 沙箱中已安装 ddgs Python 包。CLI 参数
| 参数 | 说明 | 示例 |
|---|---|---|
-q | 查询词 — 必填 | -q "search terms" |
-m | 最大结果数 | -m 5 |
-r | 地区 | -r us-en |
-t | 时间范围 | -t w（一周） |
-s | 安全搜索 | -s off |
-o | 输出格式 | -o json |
方法二：Python API（仅在验证后使用）
ddgs 已安装于该运行时后，才在 execute_code 或其他 Python 运行时中使用 DDGS 类。不要默认认为 execute_code 包含第三方包。execute_code 中使用 ddgs"execute_code 包含 ddgs"execute_code 中默认可用"max_results 必须始终以关键字参数形式传入 — 所有方法中以位置参数传入均会报错。文本搜索
title、href、body新闻搜索
date、title、body、url、image、source图片搜索
title、image、thumbnail、url、height、width、source视频搜索
title、content、description、duration、provider、published、statistics、uploader快速参考
| 方法 | 适用场景 | 关键字段 |
|---|---|---|
text() | 通用研究、公司信息 | title, href, body |
news() | 时事动态、最新更新 | date, title, source, body, url |
images() | 视觉内容、示意图 | title, image, thumbnail, url |
videos() | 教程、演示 | title, content, duration, provider |
工作流：先搜索后提取
web_extract、browser 工具或 curl 提取最相关的 URL。ddgs 后使用：web_extract 或其他内容获取工具提取最佳 URL 的内容。限制
ddgs 返回摘要，而非完整页面内容。如需完整文章/页面，请使用 web_extract、browser 工具或 curl。ddgs 版本间返回字段可能有所不同。对可选字段使用 .get() 以避免 KeyError。ddgs 不代表 execute_code 能自动导入它。故障排查
| 问题 | 可能原因 | 处理方式 |
|---|---|---|
ddgs: command not found | CLI 未安装在 shell 环境中 | 安装 ddgs，或改用内置 web/browser 工具 |
ModuleNotFoundError: No module named 'ddgs' | Python 运行时未安装该包 | 在准备好该运行时之前，不要在其中使用 Python DDGS |
| 搜索无结果 | 临时限流或查询词不佳 | 等待几秒后重试，或调整查询词 |
CLI 正常但 execute_code 导入失败 | Terminal 与 execute_code 是不同的运行时 | 继续使用 CLI，或单独准备 Python 运行时 |
常 见陷阱
max_results 仅支持关键字参数：ddgs.text("query", 5) 会报错，请使用 ddgs.text("query", max_results=5)。command -v ddgs。execute_code 能导入 ddgs：除非该运行时已单独准备，否则 from ddgs import DDGS 可能抛出 ModuleNotFoundError。ddgs（原名 duckduckgo-search），使用 pip install ddgs 安装。-q 和 -m（CLI）：-q 用于查询词，-m 用于最大结果数。ddgs 返回空结果，可能是被限流。等待几秒后重试。验证版本
ddgs==9.11.2 语义验证示例。Skill 指南现将 CLI 可用性与 Python 导入可用性视为独立问题，以确保文档化的工作流与实际运行时行为一致。