ddgs-search

为何选择该技能？

🆓 完全免费 — 无需 API 密钥、无需订阅、无调用频率限制、无意外计费。

🔍 集成 8 大搜索引擎 — Google、Bing、DuckDuckGo、Brave、Yandex、Yahoo、Wikipedia 和 Mojeek。仅需一个参数即可切换引擎。大多数搜索技能仅支持单一引擎。

🎓 内置 arXiv 学术研究搜索 — 直接通过 arXiv 提供的免费 API 检索学术论文，返回作者、分类、摘要及发表日期，非常适合研究人员、学生以及 AI/ML 实践者。

🔌 即插即用式替代方案 — 输出符合 web-search-plus 规范的 JSON 格式，可无缝对接任何期望该格式的技能或工具，迁移零配置。

⚡ 轻量级设计 — 单一 pip 包，不依赖浏览器自动化，亦无需 headless Chrome。搜索耗时仅 1–3 秒。

安装

python3 scripts/install.py

支持 macOS、Linux 和 Windows。自动安装 ddgs 包，验证 CLI 可访问性，并运行一次快速搜索测试。

手动安装

pip install ddgs

网页搜索

CLI 封装器（推荐）

ddgs-search 封装器向 stdout 输出结构清晰的 JSON，无交互式提示，也不存在中止问题：

# Google（默认）
ddgs-search "your query" 5 google

# 其他搜索引擎
ddgs-search "your query" 3 duckduckgo
ddgs-search "your query" 5 brave
ddgs-search "your query" 10 yandex

Python 脚本（兼容 web-search-plus 的 JSON）

# Google（默认）
python3 scripts/search.py -q "your query" -m 5

# 其他搜索引擎
python3 scripts/search.py -q "your query" -b duckduckgo
python3 scripts/search.py -q "your query" -b brave
python3 scripts/search.py -q "your query" -b yandex
python3 scripts/search.py -q "your query" -b yahoo
python3 scripts/search.py -q "your query" -b wikipedia

输出（兼容 web-search-plus 的 JSON 格式）：

{
  "provider": "ddgs",
  "results": [
    {"title": "...", "url": "...", "snippet": "...", "published_date": "..."}
  ]
}

arXiv 搜索

# 按主题搜索
python3 scripts/arxiv_search.py -q "3D gaussian splatting" -m 10

# 按字段搜索（标题、摘要、分类）
python3 scripts/arxiv_search.py -q "ti:transformer AND cat:cs.CV" -m 5

# 按相关性而非时间排序
python3 scripts/arxiv_search.py -q "reinforcement learning" --sort-by relevance

返回作者、分类、摘要等内容，JSON 格式与上述一致。

直接使用 CLI

⚠️ 原生 ddgs text CLI 存在分页缺陷（含 input() 调用 → 在非 TTY 环境下会显示 Aborted! 并以退出码 1 终止）。请改用 ddgs-search 封装器，或添加 -o file.json 参数输出至文件。

ddgs text -q "query" -m 5 -b google -o /tmp/results.json

集成

设置 WEB_SEARCH_PLUS_PATH 环境变量，即可将本工具作为其他技能的搜索后端：

export WEB_SEARCH_PLUS_PATH="path/to/ddgs-search/scripts/search.py"