duckduckgo-search

核心用法

DuckDuckGo Search Skill 是一个封装了 duckduckgo-search Python 库的工具型技能，通过 Bash 工具链（python/pip/uv）实现网络搜索能力。该技能支持七种搜索模式：文本搜索（最常用）、新闻搜索（带时间筛选）、图片搜索（支持尺寸/类型过滤）、视频搜索（支持分辨率/时长筛选）、即时回答（快速知识查询）、搜索建议（自动补全）以及地图搜索（地理位置查询）。所有搜索均可配置地区代码（如 cn-zh、us-en）、安全搜索级别和时间范围，满足不同场景的信息获取需求。

显著优点

零成本接入：无需申请 API Key，完全免费使用，降低了开发者和用户的接入门槛。隐私优先：依托 DuckDuckGo 的隐私保护特性，不追踪用户搜索行为，适合对数据敏感的场景。功能全面：覆盖文本、多媒体、地理位置等多维度搜索，且支持即时回答和搜索建议等增强功能。灵活可控：丰富的参数配置（地区、时间、安全级别、结果数量）让搜索行为精准可控。生态兼容：可无缝衔接 browser-use 等工具，实现"搜索-访问-提取"的完整信息获取链路。

潜在缺点与局限性

反爬机制限制：作为非官方 API 封装，频繁请求可能触发 DuckDuckGo 的速率限制，需要手动添加延迟控制。结果稳定性：搜索引擎结果受 DuckDuckGo 算法调整影响，可能出现结果波动或格式变化。功能边界：不支持高级搜索语法（如 site:、filetype: 等），复杂查询场景受限。网络依赖：完全依赖外部网络连接，离线环境无法使用，且部分地区访问可能不稳定。无持久化能力：除示例中的可选 JSON 保存外，本身不提供结果缓存或历史管理功能。

适合的目标群体

该技能特别适合以下用户：需要为 AI Agent 补充实时信息能力的开发者；构建研究助手、新闻聚合、内容创作工具的产品团队；注重隐私保护、不愿使用 Google/Bing API 的个人用户；以及需要快速验证概念、搭建原型的技术爱好者。对于企业级搜索需求（如大规模数据采集、SEO 监控），建议评估专业搜索 API 服务。

使用风险

性能风险：网络延迟和 DuckDuckGo 响应速度直接影响用户体验，建议设置超时机制和降级策略。依赖风险：duckduckgo-search 库的版本更新可能引入 breaking changes，建议锁定版本。合规风险：批量爬取或自动化高频搜索可能违反 DuckDuckGo 服务条款，需遵守 robots.txt 和使用政策。数据质量风险：搜索结果未经人工审核，关键决策场景需交叉验证信息来源。