From 3a262f120a93d39d53c27adb062fceeaa8f94935 Mon Sep 17 00:00:00 2001 From: zlei9 Date: Sun, 29 Mar 2026 07:39:14 +0800 Subject: [PATCH] Initial commit with translated description --- SKILL.md | 457 +++++++++++++++++++++++++++++++++++++++++++++++++++++ _meta.json | 6 + 2 files changed, 463 insertions(+) create mode 100644 SKILL.md create mode 100644 _meta.json diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..ff5c259 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,457 @@ +--- +name: duckduckgo-search +description: 使用DuckDuckGo进行网络搜索以从互联网获取实时信息。当用户需要搜索当前事件、文档、教程或任何需要网络搜索功能的信息时使用。 +allowed-tools: Bash(duckduckgo-search:*), Bash(python:*), Bash(pip:*), Bash(uv:*) +--- + +# DuckDuckGo Web Search Skill + +这个技能通过 DuckDuckGo 搜索引擎实现网络搜索功能，帮助获取实时信息。 + +## 功能特性 + +- 🔍 基于 DuckDuckGo 的隐私友好型搜索 +- 📰 支持新闻搜索 +- 🖼️ 支持图片搜索 +- 📹 支持视频搜索 +- 🌐 无需 API Key，免费使用 +- 🔒 保护隐私，不追踪用户 + +## 安装 + +```bash +# 使用 uv 安装（推荐） +uv pip install duckduckgo-search + +# 或使用 pip 安装 +pip install duckduckgo-search +``` + +## 快速开始 + +### 命令行方式 + +```bash +# 基础文本搜索 +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) + +最常用的搜索方式，返回网页结果： + +```bash +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) + +搜索最新新闻： + +```bash +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) + +搜索图片资源： + +```bash +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) + +搜索视频内容： + +```bash +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 的即时回答： + +```bash +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) + +获取搜索建议： + +```bash +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) + +搜索地点信息： + +```bash +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() +" +``` + +## 实用脚本 + +### 通用搜索函数 + +创建一个可复用的搜索脚本： + +```bash +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() +" +``` + +### 搜索并保存结果 + +```bash +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)} 条结果') +" +``` + +### 多关键词批量搜索 + +```bash +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` | 关闭过滤 | + +## 错误处理 + +```bash +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}') +" +``` + +## 使用代理 + +如果需要使用代理： + +```bash +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)} 个结果') +" +``` + +## 常见问题 + +**安装失败？** +```bash +# 确保 pip 是最新版本 +pip install --upgrade pip +pip install duckduckgo-search + +# 或使用 uv +uv pip install duckduckgo-search +``` + +**搜索无结果？** +```bash +# 检查网络连接 +# 尝试使用代理 +# 减少搜索关键词复杂度 +# 检查地区设置是否正确 +``` + +**请求被限制？** +```bash +# 在多次搜索之间添加延迟 +import time +time.sleep(1) # 等待 1 秒 + +# 减少单次请求的结果数量 +max_results=5 # 而不是 50 +``` + +## 与其他工具集成 + +### 结合 browser-use 获取详细内容 + +```bash +# 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. **尊重版权**：搜索结果仅供参考，注意内容版权 diff --git a/_meta.json b/_meta.json new file mode 100644 index 0000000..fb59cf7 --- /dev/null +++ b/_meta.json @@ -0,0 +1,6 @@ +{ + "ownerId": "kn7e6rmb07qmpshw2vp52sw2gs80fcd0", + "slug": "duckduckgo-search", + "version": "1.0.0", + "publishedAt": 1770133991079 +} \ No newline at end of file