ddgs-web-access：Web 搜索与网页抓取

基于 ddgs 的极简封装，只做文本搜索与网页抓取（图片 / 新闻 / 视频搜索不在范围内）：

对应原生工具的用法迁移：WebSearch ≈ ddgs-web-search（域名限定在关键字中加 site:example.com）；WebFetch ≈ ddgs-web-fetch（没有 prompt 参数——正文已是 Markdown，从中自行提取答案，长文用 --start 分段读）。

调用方法

标准形式（<skill_dir> 为本 skill 目录；命令不依赖当前工作目录）：

bash "<skill_dir>/bin/ddgs-web-search" "<关键字>" -m 5
bash "<skill_dir>/bin/ddgs-web-fetch" "<url>"
bash "<skill_dir>/bin/ddgs-web-fetch" "<url1>" "<url2>"   # 批量抓取，以 ===== <url> ===== 分隔

等价形式：uv run --project "<skill_dir>" ddgs-web-search ...；Windows cmd/PowerShell 用同目录 .cmd 变体。全量参数见 --help。

常用参数

• 搜索：-m 结果数（默认 10，5-10 够用即可）；-t d/w/m/y 时效过滤；-b bing|brave|duckduckgo|wikipedia 指定引擎；--urls 只输出链接、每行一个（适合串联批量抓取）；--format json 结构化输出。
• 抓取：--max-chars 截断长度（默认 5000，长文按需调大，0 为不限）；--start N 跳过前 N 字符，与 --max-chars 配合分段读长文；--no-cache 绕过 15 分钟抓取缓存；--curl 强制用系统 curl 抓取（默认模式失败时已会自动回退到 curl，一般无需手动指定）。

输出解读

搜索结果每项为 3 行块：序号+标题 / URL / 摘要，结果之间空行分隔。无结果时 stdout 为空、stderr 提示 no results found.、退出码为 0。stderr 出现 cache hit（缓存命中）、retrying（自动重试）、truncated ... (continue with --start N)（截断续读）均属正常提示，不是错误。引用来源时带上 href 链接；抓取到的正文默认是 Markdown，其中的链接与标题可直接引用。

稳定性与纪律

已内置：抓取失败自动改用系统 curl 重试（404/410 死链除外）；搜索遇瞬时异常自动重试一次（间隔 2s）。

仍需遵守（ddgs 是多引擎聚合，请求过频会被限流，表现为"连续空结果"）：

1. 连续两次调用之间至少间隔 2 秒；
2. 连续 2 次空结果或报错：等待 10-30 秒重试一次，仍失败则向用户说明网络/代理问题；
3. 同一 URL 不要重复抓取，优先复用已获取的内容。

代理

需要代理时加 --proxy "http://127.0.0.1:7890"；未指定时依次回退 DDGS_PROXY → HTTPS_PROXY → HTTP_PROXY 环境变量。

故障排查

• 首次调用耗时 30-60 秒是正常的（uv 正在安装依赖），后续调用会快很多；
• HTTP 404：页面不存在；TimeoutException：网络慢，可加 --timeout 15 重试；
• 反复空结果：先检查网络与代理，再按限流退避处理；
• 安装、卸载与多 agent 分发见仓库 README.md。