duckduckgo-search

DuckDuckGo Web Search Skill

这个技能通过 DuckDuckGo 搜索引擎实现网络搜索功能，帮助获取实时信息。

功能特性

• 🔍 基于 DuckDuckGo 的隐私友好型搜索
• 📰 支持新闻搜索
• 🖼️ 支持图片搜索
• 📹 支持视频搜索
• 🌐 无需 API Key，免费使用
• 🔒 保护隐私，不追踪用户

安装

# 使用 uv 安装（推荐）
uv pip install duckduckgo-search

# 或使用 pip 安装
pip install duckduckgo-search

快速开始

命令行方式

# 基础文本搜索
python -c "
from duckduckgo_search import DDGS

with DDGS() as ddgs:
    results = list(ddgs.text('Python tutorial', max_results=5))
    for r in results:
        print(f\"标题: {r['title']}\")
        print(f\"链接: {r['href']}\")
        print(f\"摘要: {r['body']}\")
        print('---')
"

搜索类型

1. 文本搜索 (Text Search)

最常用的搜索方式，返回网页结果：

python -c "
from duckduckgo_search import DDGS

query = 'your search query'

with DDGS() as ddgs:
    results = list(ddgs.text(
        query,
        region='cn-zh',      # 地区设置：cn-zh(中国), us-en(美国), wt-wt(全球)
        safesearch='moderate', # 安全搜索：on, moderate, off
        timelimit='m',       # 时间范围：d(天), w(周), m(月), y(年), None(不限)
        max_results=10       # 最大结果数
    ))
    
    for i, r in enumerate(results, 1):
        print(f\"{i}. {r['title']}\")
        print(f\"   URL: {r['href']}\")
        print(f\"   摘要: {r['body'][:100]}...\")
        print()
"

2. 新闻搜索 (News Search)

搜索最新新闻：

python -c "
from duckduckgo_search import DDGS

with DDGS() as ddgs:
    results = list(ddgs.news(
        'AI technology',
        region='wt-wt',
        safesearch='moderate',
        timelimit='d',       # d=过去24小时, w=过去一周, m=过去一月
        max_results=10
    ))
    
    for r in results:
        print(f\"📰 {r['title']}\")
        print(f\"   来源: {r['source']}\")
        print(f\"   时间: {r['date']}\")
        print(f\"   链接: {r['url']}\")
        print()
"

3. 图片搜索 (Image Search)

搜索图片资源：

python -c "
from duckduckgo_search import DDGS

with DDGS() as ddgs:
    results = list(ddgs.images(
        'cute cats',
        region='wt-wt',
        safesearch='moderate',
        size='Medium',       # Small, Medium, Large, Wallpaper
        type_image='photo',  # photo, clipart, gif, transparent, line
        layout='Square',     # Square, Tall, Wide
        max_results=10
    ))
    
    for r in results:
        print(f\"🖼️ {r['title']}\")
        print(f\"   图片: {r['image']}\")
        print(f\"   缩略图: {r['thumbnail']}\")
        print(f\"   来源: {r['source']}\")
        print()
"