duckduckgo-searchPerforms 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 requires web search capabilities.
Install via ClawdBot CLI:
clawdbot install 10e9928a/duckduckgo-search这个技能通过 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('---')
"
最常用的搜索方式,返回网页结果:
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()
"
搜索最新新闻:
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()
"
搜索图片资源:
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()
"
搜索视频内容:
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()
"
获取 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')}\")
"
获取搜索建议:
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']}\")
"
搜索地点信息:
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]}...\")
"
| 代码 | 地区 |
|------|------|
| cn-zh | 中国 |
| us-en | 美国 |
| uk-en | 英国 |
| jp-jp | 日本 |
| kr-kr | 韩国 |
| wt-wt | 全球 (无地区限制) |
| 值 | 含义 |
|----|------|
| d | 过去 24 小时 |
| w | 过去一周 |
| m | 过去一月 |
| y | 过去一年 |
| None | 不限制 |
| 值 | 含义 |
|----|------|
| 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
# 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 <url_from_search>
browser-use state
⚠️ 使用建议:
time.sleep()Generated Feb 24, 2026
Startups can use this skill to conduct competitive analysis and gather industry trends without needing expensive API keys. It enables real-time web searches for competitor websites, news mentions, and market data, helping founders make informed decisions quickly.
Educators and e-learning platforms can leverage this skill to find up-to-date tutorials, documentation, and multimedia resources for courses. It supports text, image, and video searches, allowing for the compilation of diverse learning materials from the web.
Journalists and media outlets can utilize the news search feature to track breaking stories, verify facts, and gather sources across regions. The timelimit parameter helps filter recent events, ensuring timely and relevant information for reporting.
Small businesses or travel services can use the maps search to find nearby amenities, such as coffee shops or hotels, based on location. This aids in planning, marketing, or providing recommendations to customers without relying on proprietary APIs.
Product managers and developers can search for technical documentation, user feedback, and competitor features to inform design and updates. The instant answers and suggestions features provide quick insights, streamlining the research phase of development cycles.
Offer a basic free tier for limited searches and charge for advanced features like higher result limits, custom regions, or priority access. This model attracts small users while generating revenue from enterprises needing scalable solutions.
Build a platform that aggregates search results into curated reports or dashboards for specific industries, such as news summaries or market analyses. Monetize through premium subscriptions or one-time report purchases.
Provide integration services to embed this search skill into existing applications, like chatbots or CRM systems, with custom configurations and support. Charge based on integration complexity, maintenance, and usage volume.
💬 Integration Tip
Integrate this skill by wrapping the provided Python scripts into modular functions, allowing easy calls from other applications with parameters like query type and region for flexibility.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.