用途
DuckDuckGo Web Search Skill 通过 DuckDuckGo 搜索引擎实现网络搜索,用于获取实时互联网信息。它基于 Python 库 duckduckgo-search 提供搜索能力,可作为技能集成到智能体或脚本中。
主要能力
- 文本搜索:返回网页结果的标题、链接和摘要。
- 新闻搜索:返回新闻标题、来源、时间和链接,可按时间范围筛选。
- 图片搜索:可设置尺寸、图片类型和布局。
- 视频搜索:可设置时间范围、分辨率和时长。
- 即时回答:获取 DuckDuckGo 的即时答案。
- 搜索建议:获取关键词的搜索建议短语。
- 地图搜索:按地点查询地点信息,包括地址、电话和坐标。
该库无需 API Key,免费使用,强调隐私保护、不追踪用户。多数搜索接口支持 region(地区)、safesearch(安全搜索)、timelimit(时间范围)和 max_results(最大结果数)等参数。
使用方式
安装:
uv pip install duckduckgo-search
或:
pip install duckduckgo-search
基础文本搜索示例:
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('---')
新闻搜索示例:
from duckduckgo_search import DDGS
with DDGS() as ddgs:
results = list(ddgs.news(
'AI technology',
region='wt-wt',
safesearch='moderate',
timelimit='d',
max_results=10
))
for r in results:
print(f"📰 {r['title']}")
print(f" 来源: {r['source']}")
print(f" 时间: {r['date']}")
print(f" 链接: {r['url']}")
图片搜索示例:
from duckduckgo_search import DDGS
with DDGS() as ddgs:
results = list(ddgs.images(
'cute cats',
region='wt-wt',
safesearch='moderate',
size='Medium',
type_image='photo',
layout='Square',
max_results=10
))
for r in results:
print(f"🖼️ {r['title']}")
print(f" 图片: {r['image']}")
print(f" 缩略图: {r['thumbnail']}")
print(f" 来源: {r['source']}")
视频搜索示例:
from duckduckgo_search import DDGS
with DDGS() as ddgs:
results = list(ddgs.videos(
'Python programming',
region='wt-wt',
safesearch='moderate',
timelimit='w',
resolution='high',
duration='medium',
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']}")
即时回答、搜索建议与地图搜索:
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')}")
from duckduckgo_search import DDGS
with DDGS() as ddgs:
suggestions = list(ddgs.suggestions('python'))
print('🔍 搜索建议:')
for s in suggestions:
print(f" - {s['phrase']}")
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']}")
主要参数
- region:cn-zh(中国)、us-en(美国)、uk-en(英国)、jp-jp(日本)、kr-kr(韩国)、wt-wt(全球,无地区限制)。
- timelimit:d(过去 24 小时)、w(过去一周)、m(过去一月)、y(过去一年)、None(不限制)。
- safesearch:on(严格过滤)、moderate(适度过滤,默认)、off(关闭过滤)。
代理可在创建 DDGS 时传入,例如 DDGS(proxy='http://127.0.0.1:7890')。
适用场景
- 为智能体或自动化脚本补充实时网络搜索。
- 检索当前事件、新闻、图片、视频等公开信息。
- 需要隐私友好、免 API Key 搜索的轻量集成场景。
- 批量关键词搜索并保存结果(可配合 JSON 导出)。
限制与注意事项
- 应遵守使用频率限制,避免短时间内大量请求;批量搜索建议在请求之间添加
time.sleep()延迟。 - 合理设置 max_results,不要一次请求过多结果。
- 建议添加错误处理,可捕获 DuckDuckGoSearchException。
- 若搜索无结果,可检查网络连接、尝试代理、简化关键词或检查地区设置。
- 搜索结果仅供参考,需注意内容版权。