Performs web searches using DuckDuckGo to retrieve real-time information from the internet. Use when the user needs to search for current events, documentation, tutorials, or any information that requ

DuckDuckGo Web Search Skill

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

功能特性

安装

# 使用 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()
"

4. 视频搜索 (Video Search)

搜索视频内容：

python -c "
from duckduckgo_search import DDGS
with DDGS() as ddgs:
    results = list(ddgs.videos(
        'Python programming',
        region='wt-wt',
        safesearch='moderate',
        timelimit='w',       # d, w, m
        resolution='high',   # high, standard
        duration='medium',   # short, medium, long
        max_results=10
    ))
    
    for r in results:
        print(f\"📹 {r['title']}\")
        print(f\"   时长: {r.get('duration', 'N/A')}\")
        print(f\"   来源: {r['publisher']}\")
        print(f\"   链接: {r['content']}\")
        print()
"

5. 即时回答 (Instant Answers)

获取 DuckDuckGo 的即时回答：

python -c "
from duckduckgo_search import DDGS
with DDGS() as ddgs:
    results = ddgs.answers('what is python programming language')
    
    for r in results:
        print(f\"📚 {r['text']}\")
        print(f\"   来源: {r.get('url', 'DuckDuckGo')}\")
"

6. 建议搜索 (Suggestions)

获取搜索建议：

python -c "
from duckduckgo_search import DDGS
with DDGS() as ddgs:
    suggestions = list(ddgs.suggestions('python'))
    
    print('🔍 搜索建议:')
    for s in suggestions:
        print(f\"   - {s['phrase']}\")
"

7. 地图搜索 (Maps Search)

搜索地点信息：

python -c "
from duckduckgo_search import DDGS
with DDGS() as ddgs:
    results = list(ddgs.maps(
        'coffee shop',
        place='Beijing, China',
        max_results=10
    ))
    
    for r in results:
        print(f\"📍 {r['title']}\")
        print(f\"   地址: {r['address']}\")
        print(f\"   电话: {r.get('phone', 'N/A')}\")
        print(f\"   坐标: {r['latitude']}, {r['longitude']}\")
        print()
"

实用脚本

通用搜索函数

创建一个可复用的搜索脚本：

python -c "
from duckduckgo_search import DDGS
import json
def web_search(query, search_type='text', max_results=5, region='wt-wt', timelimit=None):
    '''
    执行 DuckDuckGo 搜索
    
    参数:
        query: 搜索关键词
        search_type: 搜索类型 (text, news, images, videos)
        max_results: 最大结果数
        region: 地区 (cn-zh, us-en, wt-wt)
        timelimit: 时间限制 (d, w, m, y)
    '''
    with DDGS() as ddgs:
        if search_type == 'text':
            results = list(ddgs.text(query, region=region, timelimit=timelimit, max_results=max_results))
        elif search_type == 'news':
            results = list(ddgs.news(query, region=region, timelimit=timelimit, max_results=max_results))
        elif search_type == 'images':
            results = list(ddgs.images(query, region=region, max_results=max_results))
        elif search_type == 'videos':
            results = list(ddgs.videos(query, region=region, timelimit=timelimit, max_results=max_results))
        else:
            results = []
    
    return results
使用示例
query = 'Python 3.12 new features'
results = web_search(query, search_type='text', max_results=5)
print(f'🔍 搜索: {query}')
print(f'📊 找到 {len(results)} 个结果')
print()
for i, r in enumerate(results, 1):
    print(f\"{i}. {r['title']}\")
    print(f\"   {r['href']}\")
    print(f\"   {r['body'][:150]}...\")
    print()
"

搜索并保存结果

python -c "
from duckduckgo_search import DDGS
import json
from datetime import datetime
query = 'latest tech news'
output_file = f'search_results_{datetime.now().strftime(\"%Y%m%d_%H%M%S\")}.json'
with DDGS() as ddgs:
    results = list(ddgs.text(query, max_results=10))
保存到 JSON 文件
with open(output_file, 'w', encoding='utf-8') as f:
    json.dump({
        'query': query,
        'timestamp': datetime.now().isoformat(),
        'results': results
    }, f, ensure_ascii=False, indent=2)
print(f'✅ 搜索结果已保存到: {output_file}')
print(f'📊 共 {len(results)} 条结果')
"

多关键词批量搜索

python -c "
from duckduckgo_search import DDGS
import time
queries = [
    'Python best practices 2024',
    'React vs Vue 2024',
    'AI development tools'
]
all_results = {}
with DDGS() as ddgs:
    for query in queries:
        print(f'🔍 搜索: {query}')
        results = list(ddgs.text(query, max_results=3))
        all_results[query] = results
        print(f'   找到 {len(results)} 个结果')
        time.sleep(1)  # 避免请求过快
print()
print('=' * 50)
print('📊 搜索汇总')
print('=' * 50)
for query, results in all_results.items():
    print(f'\n🔎 {query}:')
    for i, r in enumerate(results, 1):
        print(f\"   {i}. {r['title'][:60]}...\")
"

参数说明

地区代码 (region)

| 代码 | 地区 | |------|------| | cn-zh | 中国 | | us-en | 美国 | | uk-en | 英国 | | jp-jp | 日本 | | kr-kr | 韩国 | | wt-wt | 全球 (无地区限制) |

时间限制 (timelimit)

| 值 | 含义 | |----|------| | d | 过去 24 小时 | | w | 过去一周 | | m | 过去一月 | | y | 过去一年 | | None | 不限制 |

安全搜索 (safesearch)

| 值 | 含义 | |----|------| | on | 严格过滤 | | moderate | 适度过滤 (默认) | | off | 关闭过滤 |

错误处理

python -c "
from duckduckgo_search import DDGS
from duckduckgo_search.exceptions import DuckDuckGoSearchException
try:
    with DDGS() as ddgs:
        results = list(ddgs.text('test query', max_results=5))
        print(f'✅ 搜索成功，找到 {len(results)} 个结果')
except DuckDuckGoSearchException as e:
    print(f'❌ 搜索出错: {e}')
except Exception as e:
    print(f'❌ 未知错误: {e}')
"

使用代理

如果需要使用代理：

python -c "
from duckduckgo_search import DDGS
设置代理
proxy = 'http://127.0.0.1:7890'  # 替换为你的代理地址
with DDGS(proxy=proxy) as ddgs:
    results = list(ddgs.text('test query', max_results=5))
    print(f'通过代理搜索成功，找到 {len(results)} 个结果')
"

常见问题

安装失败？

# 确保 pip 是最新版本
pip install --upgrade pip
pip install duckduckgo-search
或使用 uv
uv pip install duckduckgo-search

搜索无结果？

# 检查网络连接
尝试使用代理
减少搜索关键词复杂度
检查地区设置是否正确

请求被限制？

# 在多次搜索之间添加延迟
import time
time.sleep(1)  # 等待 1 秒
减少单次请求的结果数量
max_results=5  # 而不是 50

与其他工具集成

结合 browser-use 获取详细内容

# 1. 先用 DuckDuckGo 搜索
python -c "
from duckduckgo_search import DDGS
with DDGS() as ddgs:
    results = list(ddgs.text('Python async tutorial', max_results=1))
    if results:
        url = results[0]['href']
        print(f'URL: {url}')
"
2. 用 browser-use 打开并获取详细内容
browser-use open 
browser-use state

注意事项

⚠️ 使用建议：

1. 遵守使用频率限制：避免短时间内大量请求 2. 合理设置结果数量：不要一次请求过多结果 3. 添加适当延迟：批量搜索时在请求之间添加 time.sleep() 4. 处理异常情况：始终添加错误处理代码 5. 尊重版权：搜索结果仅供参考，注意内容版权

安装失败？

# 确保 pip 是最新版本
pip install --upgrade pip
pip install duckduckgo-search
或使用 uv
uv pip install duckduckgo-search

搜索无结果？

# 检查网络连接
尝试使用代理
减少搜索关键词复杂度
检查地区设置是否正确

请求被限制？

# 在多次搜索之间添加延迟
import time
time.sleep(1)  # 等待 1 秒
减少单次请求的结果数量
max_results=5  # 而不是 50