Web Search
@phialsprute/Web Search
联网搜索并汇总资料
概述
Web Search
Overview
Search the web using DuckDuckGo's API to find information across web pages, news articles, images, and videos. Returns results in multiple formats (text, markdown, JSON) with filtering options for time range, region, and safe search.
When to Use This Skill
Use this skill when users request:
- Web searches for information or resources
- Finding current or recent information online
- Looking up news articles about specific topics
- Searching for images by description or topic
- Finding videos on specific subjects
- Research requiring current web data
- Fact-checking or verification using web sources
- Gathering URLs and resources on a topic
Prerequisites
Install the required dependency:
bashpip install duckduckgo-searchThis library provides a simple Python interface to DuckDuckGo's search API without requiring API keys or authentication.
Core Capabilities
1. Basic Web Search
Search for web pages and information:
bashpython scripts/search.py "<query>"**Example:**
bashpython scripts/search.py "python asyncio tutorial"Returns the top 10 web results with titles, URLs, and descriptions in a clean text format.
2. Limiting Results
Control the number of results returned:
bashpython scripts/search.py "<query>" --max-results <N>**Example:**
bashpython scripts/search.py "machine learning frameworks" --max-results 20Useful for:
- Getting more comprehensive results (increase limit)
- Quick lookups with fewer results (decrease limit)
- Balancing detail vs. processing time
3. Time Range Filtering
Filter results by recency:
bashpython scripts/search.py "<query>" --time-range <d|w|m|y>**Time range options:**
d- Past dayw- Past weekm- Past monthy- Past year
**Example:**
bashpython scripts/search.py "artificial intelligence news" --time-range wGreat for:
- Finding recent news or updates
- Filtering out outdated content
- Tracking recent developments
4. News Search
Search specifically for news articles:
bashpython scripts/search.py "<query>" --type news**Example:**
bashpython scripts/search.py "climate change" --type news --time-range w --max-results 15News results include:
- Article title
- Source publication
- Publication date
- URL
- Article summary/description
5. Image Search
Search for images:
bashpython scripts/search.py "<query>" --type images**Example:**
bashpython scripts/search.py "sunset over mountains" --type images --max-results 20**Image filtering options:**
Size filters:
bashpython scripts/search.py "landscape photos" --type images --image-size LargeOptions: Small, Medium, Large, Wallpaper
Color filters:
bashpython scripts/search.py "abstract art" --type images --image-color BlueOptions: color, Monochrome, Red, Orange, Yellow, Green, Blue, Purple, Pink, Brown, Black, Gray, Teal, White
Type filters:
bashpython scripts/search.py "icons" --type images --image-type transparentOptions: photo, clipart, gif, transparent, line
Layout filters:
bashpython scripts/search.py "wallpapers" --type images --image-layout WideOptions: Square, Tall, Wide
Image results include:
- Image title
- Image URL (direct link to image)
- Thumbnail URL
- Source website
- Dimensions (width x height)
6. Video Search
Search for videos:
bashpython scripts/search.py "<query>" --type videos**Example:**
bashpython scripts/search.py "python tutorial" --type videos --max-results 15**Video filtering options:**
Duration filters:
bashpython scripts/search.py "cooking recipes" --type videos --video-duration shortOptions: short, medium, long
Resolution filters:
bashpython scripts/search.py "documentary" --type videos --video-resolution highOptions: high, standard
Video results include:
- Video title
- Publisher/channel
- Duration
- Publication date
- Video URL
- Description
7. Region-Specific Search
Search with region-specific results:
bashpython scripts/search.py "<query>" --region <region-code>**Common region codes:**
us-en- United States (English)uk-en- United Kingdom (English)ca-en- Canada (English)au-en- Australia (English)de-de- Germany (German)fr-fr- France (French)wt-wt- Worldwide (default)
**Example:**
bashpython scripts/search.py "local news" --region us-en --type news8. Safe Search Control
Control safe search filtering:
bashpython scripts/search.py "<query>" --safe-search <on|moderate|off>**Options:**
on- Strict filteringmoderate- Balanced filtering (default)off- No filtering
**Example:**
bashpython scripts/search.py "medical information" --safe-search on9. Output Formats
Choose how results are formatted:
**Text format (default):**
bashpython scripts/search.py "quantum computing"Clean, readable plain text with numbered results.
**Markdown format:**
bashpython scripts/search.py "quantum computing" --format markdownFormatted markdown with headers, bold text, and links.
**JSON format:**
bashpython scripts/search.py "quantum computing" --format jsonStructured JSON data for programmatic processing.
10. Saving Results to File
Save search results to a file:
bashpython scripts/search.py "<query>" --output <file-path>**Example:**
bashpython scripts/search.py "artificial intelligence" --output ai_results.txt
python scripts/search.py "AI news" --type news --format markdown --output ai_news.md
python scripts/search.py "AI research" --format json --output ai_data.jsonThe file format is determined by the --format flag, not the file extension.
Output Format Examples
Text Format
1. Page Title Here URL: https://example.com/page Brief description of the page content... 2. Another Result URL: https://example.com/another Another description...
Markdown Format
markdown## 1. Page Title Here
**URL:** https://example.com/page
Brief description of the page content...
## 2. Another Result
**URL:** https://example.com/another
Another description...JSON Format
json[
{
"title": "Page Title Here",
"href": "https://example.com/page",
"body": "Brief description of the page content..."
},
{
"title": "Another Result",
"href": "https://example.com/another",
"body": "Another description..."
}
]Common Usage Patterns
Research on a Topic
Gather comprehensive information about a subject:
bash# Get overview from web
python scripts/search.py "machine learning basics" --max-results 15 --output ml_web.txt
# Get recent news
python scripts/search.py "machine learning" --type news --time-range m --output ml_news.txt
# Find tutorial videos
python scripts/search.py "machine learning tutorial" --type videos --max-results 10 --output ml_videos.txtCurrent Events Monitoring
Track news on specific topics:
bashpython scripts/search.py "climate summit" --type news --time-range d --format markdown --output daily_climate_news.mdFinding Visual Resources
Search for images with specific criteria:
bashpython scripts/search.py "data visualization examples" --type images --image-type photo --image-size Large --max-results 25 --output viz_images.txtFact-Checking
Verify information with recent sources:
bashpython scripts/search.py "specific claim to verify" --time-range w --max-results 20Academic Research
Find resources on scholarly topics:
bashpython scripts/search.py "quantum entanglement research" --time-range y --max-results 30 --output quantum_research.txtMarket Research
Gather information about products or companies:
bashpython scripts/search.py "electric vehicle market 2025" --max-results 20 --format markdown --output ev_market.md
python scripts/search.py "EV news" --type news --time-range m --output ev_news.txtImplementation Approach
When users request web searches:
1. **Identify search intent**:
- What type of content (web, news, images, videos)?
- How recent should results be?
- How many results are needed?
- Any filtering requirements?
2. **Configure search parameters**:
- Choose appropriate search type (
--type) - Set time range if currency matters (
--time-range) - Adjust result count (
--max-results) - Apply filters (image size, video duration, etc.)
3. **Select output format**:
- Text for quick reading
- Markdown for documentation
- JSON for further processing
4. **Execute search**:
- Run the search command
- Save to file if results need to be preserved
- Print to stdout for immediate review
5. **Process results**:
- Read saved files if needed
- Extract URLs or specific information
- Combine results from multiple searches
Quick Reference
**Command structure:**
bashpython scripts/search.py "<query>" [options]**Essential options:**
-t, --type- Search type (web, news, images, videos)-n, --max-results- Maximum results (default: 10)--time-range- Time filter (d, w, m, y)-r, --region- Region code (e.g., us-en, uk-en)--safe-search- Safe search level (on, moderate, off)-f, --format- Output format (text, markdown, json)-o, --output- Save to file
**Image-specific options:**
--image-size- Size filter (Small, Medium, Large, Wallpaper)--image-color- Color filter--image-type- Type filter (photo, clipart, gif, transparent, line)--image-layout- Layout filter (Square, Tall, Wide)
**Video-specific options:**
--video-duration- Duration filter (short, medium, long)--video-resolution- Resolution filter (high, standard)
**Get full help:**
bashpython scripts/search.py --helpBest Practices
1. **Be specific** - Use clear, specific search queries for better results 2. **Use time filters** - Apply --time-range for current information 3. **Adjust result count** - Start with 10-20 results, increase if needed 4. **Save important searches** - Use --output to preserve results 5. **Choose appropriate type** - Use news search for current events, web for general info 6. **Use JSON for automation** - JSON format is easiest to parse programmatically 7. **Respect usage** - Don't hammer the API with rapid repeated searches
Troubleshooting
**Common issues:**
- **"Missing required dependency"**: Run
pip install duckduckgo-search - **No results found**: Try broader search terms or remove time filters
- **Timeout errors**: The search service may be temporarily unavailable; retry after a moment
- **Rate limiting**: Space out searches if making many requests
- **Unexpected results**: DuckDuckGo's results may differ from Google; try refining the query
**Limitations:**
- Results quality depends on DuckDuckGo's index and algorithms
- No advanced search operators (unlike Google's site:, filetype:, etc.)
- Image and video searches may have fewer results than web search
- No control over result ranking or relevance scoring
- Some specialized searches may work better on dedicated search engines
Advanced Use Cases
Combining Multiple Searches
Gather comprehensive information by combining search types:
bash# Web overview
python scripts/search.py "topic" --max-results 15 --output topic_web.txt
# Recent news
python scripts/search.py "topic" --type news --time-range w --output topic_news.txt
# Images
python scripts/search.py "topic" --type images --max-results 20 --output topic_images.txtProgrammatic Processing
Use JSON output for automated processing:
bashpython scripts/search.py "research topic" --format json --output results.json
# Then process with another script
python analyze_results.py results.jsonBuilding a Knowledge Base
Create searchable documentation from web results:
bash# Search multiple related topics
python scripts/search.py "topic1" --format markdown --output kb/topic1.md
python scripts/search.py "topic2" --format markdown --output kb/topic2.md
python scripts/search.py "topic3" --format markdown --output kb/topic3.mdResources
scripts/search.py
The main search tool implementing DuckDuckGo search functionality. Key features:
- **Multiple search types** - Web, news, images, and videos
- **Flexible filtering** - Time range, region, safe search, and type-specific filters
- **Multiple output formats** - Text, Markdown, and JSON
- **File output** - Save results for later processing
- **Clean formatting** - Human-readable output with all essential information
- **Error handling** - Graceful handling of network errors and empty results
The script can be executed directly and includes comprehensive command-line help via --help.
概述来自技能作者的 SKILL.md 文档;中英文以作者发布为准。
安装使用
- 1. 下载 Agent Doctor(本站 /download)
- 2. 下载本页 zip 并解压(目录内含 SKILL.md)
- 3. 打开 Agent Doctor → 技能 → 添加,选中解压后的目录
安全校验
- ✓ 包由本站同步托管,不经第三方跳转
- ✓ 结构校验:必含 SKILL.md,无路径穿越条目
- ✓ 体积封顶:解压总大小 ≤ 30MB、文件数 ≤ 300
- ✓ 实测 3 个文件,解压共 31.0 KB
sha256 8e1d494f7a991ddb9ce03223c72c56c756bf5c7eb62e3b9eda8320ea0c146934