关于 pravidhi-ddgs-internet-search
pravidhi-ddgs-internet-search 是通过 DuckDuckGo Search 库进行网络搜索的 Agent 技能。它提供适用于超时情况的安全模式,并以 JSON 返回软失败信息,供 Agent 处理。
主要功能
- 01使用 DuckDuckGo Search 搜索
- 02限制搜索结果数量
- 03使用带额外延迟的安全模式
- 04软失败时返回 JSON
适用场景
- 01搜索当前话题的网络信息
- 02重试遇到超时的搜索
- 03在 Agent 中处理搜索错误
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pravidhi-net/ skills --skill pravidhi-ddgs-internet-search安装后在 Claude Code 中输入/pravidhi-ddgs-internet-search确认已加载。
附带文件references/CLI_OPTIONS.mdscripts/search.py
详细介绍
互联网搜索技能(DDGS)
由 Pravidhi 开发和维护
此技能使用 DuckDuckGo Search 库执行互联网搜索,专为 AI Agent 设计,力求易于使用且不会影响上下文安全。
前置条件:安装
此技能需要 duckduckgo-search 库。请将其安装到 Agent 当前使用的 Python 环境中。
pip install duckduckgo-search
用法
标准搜索: 使用当前的 Python 解释器运行脚本。
# Syntax: python scripts/search.py -q "QUERY" -m MAX_RESULTS
python scripts/search.py -q "AI funding 2026" -m 3
安全模式(遇到超时问题时使用):
脚本包含 --safe 标志,可增加额外延迟(3s)并停用激进的后端。
python scripts/search.py -q "latest linux kernel features" -m 5 --safe
已知限制和故障排查
警告: 此技能依赖抓取 DuckDuckGo 数据,并非官方 API。
-
速率限制 / IP 封锁:
- 症状: 出现
429 Too Many Requests或Ratelimit错误。 - 原因: DuckDuckGo 经常会标记云端 / 数据中心 IP(AWS、GCP)。
- 解决方法: 等待 60 秒。尝试使用
--safe标志。如果问题持续存在,请使用住宅代理或改用基于 API 的技能。
- 症状: 出现
-
软失败:
- 脚本设计为“软失败”。它不会以非零退出代码崩溃,而是返回包含
status: error的 JSON 对象。Agent 应解析 JSON 输出,以妥善处理错误。
- 脚本设计为“软失败”。它不会以非零退出代码崩溃,而是返回包含
参考资料
- CLI_OPTIONS.md - 脚本参数参考。
评论
支持 Markdown