SuperAPI AI 工具集

duckduckgo-search

通用与其它

查看项目

更新于 11-02 02:29

技能介绍

用途

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。
  • 若搜索无结果,可检查网络连接、尝试代理、简化关键词或检查地区设置。
  • 搜索结果仅供参考,需注意内容版权。