mcpField
P
pravidhi-ddgs-internet-search

pravidhi-ddgs-internet-search

github.com/pravidhi-net生产力067 次安装34 周前更新
代码仓库

关于 pravidhi-ddgs-internet-search

pravidhi-ddgs-internet-search 是通过 DuckDuckGo Search 库进行网络搜索的 Agent 技能。它提供适用于超时情况的安全模式,并以 JSON 返回软失败信息,供 Agent 处理。

主要功能

  1. 01使用 DuckDuckGo Search 搜索
  2. 02限制搜索结果数量
  3. 03使用带额外延迟的安全模式
  4. 04软失败时返回 JSON

适用场景

  1. 01搜索当前话题的网络信息
  2. 02重试遇到超时的搜索
  3. 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。

  1. 速率限制 / IP 封锁:

    • 症状: 出现 429 Too Many Requests 或 Ratelimit 错误。
    • 原因: DuckDuckGo 经常会标记云端 / 数据中心 IP(AWS、GCP)。
    • 解决方法: 等待 60 秒。尝试使用 --safe 标志。如果问题持续存在,请使用住宅代理或改用基于 API 的技能。
  2. 软失败:

    • 脚本设计为“软失败”。它不会以非零退出代码崩溃,而是返回包含 status: error 的 JSON 对象。Agent 应解析 JSON 输出,以妥善处理错误。

参考资料

评论

支持 Markdown